NeptuneGraph / Client / create_graph

create_graph

NeptuneGraph.Client.create_graph(**kwargs)

Creates a new Neptune Analytics graph.

See also: AWS API Documentation

Request Syntax

response = client.create_graph(
    graphName='string',
    tags={
        'string': 'string'
    },
    publicConnectivity=True|False,
    kmsKeyIdentifier='string',
    vectorSearchConfiguration={
        'dimension': 123
    },
    replicaCount=123,
    deletionProtection=True|False,
    provisionedMemory=123
)

Parameters:

• graphName (string) –

  [REQUIRED]

  A name for the new Neptune Analytics graph to be created.

  The name must contain from 1 to 63 letters, numbers, or hyphens, and its first character must be a letter. It cannot end with a hyphen or contain two consecutive hyphens.

• tags (dict) –

  Adds metadata tags to the new graph. These tags can also be used with cost allocation reporting, or used in a Condition statement in an IAM policy.

  • (string) –

    • (string) –

• publicConnectivity (boolean) – Specifies whether or not the graph can be reachable over the internet. All access to graphs IAM authenticated. ( true to enable, or false to disable.

• kmsKeyIdentifier (string) – Specifies a KMS key to use to encrypt data in the new graph.

• vectorSearchConfiguration (dict) –

  Specifies the number of dimensions for vector embeddings that will be loaded into the graph. The value is specified as ``dimension=``value. Max = 65,535

  • dimension (integer) – [REQUIRED]

    The number of dimensions.

• replicaCount (integer) – The number of replicas in other AZs. Min =0, Max = 2, Default =1

• deletionProtection (boolean) – Indicates whether or not to enable deletion protection on the graph. The graph can’t be deleted when deletion protection is enabled. ( true or false).

• provisionedMemory (integer) –

  [REQUIRED]

  The provisioned memory-optimized Neptune Capacity Units (m-NCUs) to use for the graph. Min = 128

Return type:

dict

Returns:

Response Syntax

{
    'id': 'string',
    'name': 'string',
    'arn': 'string',
    'status': 'CREATING'|'AVAILABLE'|'DELETING'|'RESETTING'|'UPDATING'|'SNAPSHOTTING'|'FAILED',
    'statusReason': 'string',
    'createTime': datetime(2015, 1, 1),
    'provisionedMemory': 123,
    'endpoint': 'string',
    'publicConnectivity': True|False,
    'vectorSearchConfiguration': {
        'dimension': 123
    },
    'replicaCount': 123,
    'kmsKeyIdentifier': 'string',
    'sourceSnapshotId': 'string',
    'deletionProtection': True|False,
    'buildNumber': 'string'
}

Response Structure

• (dict) –

  • id (string) –

    The ID of the graph.

  • name (string) –

    The graph name. For example: my-graph-1.

    The name must contain from 1 to 63 letters, numbers, or hyphens, and its first character must be a letter. It cannot end with a hyphen or contain two consecutive hyphens.

  • arn (string) –

    The ARN of the graph.

  • status (string) –

    The current status of the graph.

  • statusReason (string) –

    The reason the status was given.

  • createTime (datetime) –

    The time when the graph was created.

  • provisionedMemory (integer) –

    The provisioned memory-optimized Neptune Capacity Units (m-NCUs) to use for the graph. Min = 128

  • endpoint (string) –

    The graph endpoint.

  • publicConnectivity (boolean) –

    Specifies whether or not the graph can be reachable over the internet. All access to graphs IAM authenticated.

  • vectorSearchConfiguration (dict) –

    The vector-search configuration for the graph, which specifies the vector dimension to use in the vector index, if any.

    • dimension (integer) –

      The number of dimensions.

  • replicaCount (integer) –

    The number of replicas in other AZs.

  • kmsKeyIdentifier (string) –

    Specifies the KMS key used to encrypt data in the new graph.

  • sourceSnapshotId (string) –

    The ID of the source graph.

  • deletionProtection (boolean) –

    A value that indicates whether the graph has deletion protection enabled. The graph can’t be deleted when deletion protection is enabled.

  • buildNumber (string) –

    The build number of the graph software.

Exceptions

• NeptuneGraph.Client.exceptions.ServiceQuotaExceededException

• NeptuneGraph.Client.exceptions.ThrottlingException

• NeptuneGraph.Client.exceptions.ValidationException

• NeptuneGraph.Client.exceptions.ConflictException

• NeptuneGraph.Client.exceptions.InternalServerException