Amazon Neptune Graph 2023-11-29
- Client: Aws\NeptuneGraph\NeptuneGraphClient
- Service ID: neptune-graph
- Version: 2023-11-29
This page describes the parameters and results for the operations of the Amazon Neptune Graph (2023-11-29), and shows how to use the Aws\NeptuneGraph\NeptuneGraphClient object to call the described operations. This documentation is specific to the 2023-11-29 API version of the service.
Operation Summary
Each of the following operations can be created from a client using
$client->getCommand('CommandName')
, where "CommandName" is the
name of one of the following operations. Note: a command is a value that
encapsulates an operation and the parameters used to create an HTTP request.
You can also create and send a command immediately using the magic methods
available on a client object: $client->commandName(/* parameters */)
.
You can send the command asynchronously (returning a promise) by appending the
word "Async" to the operation name: $client->commandNameAsync(/* parameters */)
.
- CancelExportTask ( array $params = [] )
- Cancel the specified export task.
- CancelImportTask ( array $params = [] )
- Deletes the specified import task.
- CancelQuery ( array $params = [] )
- Cancels a specified query.
- CreateGraph ( array $params = [] )
- Creates a new Neptune Analytics graph.
- CreateGraphSnapshot ( array $params = [] )
- Creates a snapshot of the specific graph.
- CreateGraphUsingImportTask ( array $params = [] )
- Creates a new Neptune Analytics graph and imports data into it, either from Amazon Simple Storage Service (S3) or from a Neptune database or a Neptune database snapshot.
- CreatePrivateGraphEndpoint ( array $params = [] )
- Create a private graph endpoint to allow private access from to the graph from within a VPC.
- DeleteGraph ( array $params = [] )
- Deletes the specified graph.
- DeleteGraphSnapshot ( array $params = [] )
- Deletes the specifed graph snapshot.
- DeletePrivateGraphEndpoint ( array $params = [] )
- Deletes a private graph endpoint.
- ExecuteQuery ( array $params = [] )
- Execute an openCypher query.
- GetExportTask ( array $params = [] )
- Retrieves a specified export task.
- GetGraph ( array $params = [] )
- Gets information about a specified graph.
- GetGraphSnapshot ( array $params = [] )
- Retrieves a specified graph snapshot.
- GetGraphSummary ( array $params = [] )
- Gets a graph summary for a property graph.
- GetImportTask ( array $params = [] )
- Retrieves a specified import task.
- GetPrivateGraphEndpoint ( array $params = [] )
- Retrieves information about a specified private endpoint.
- GetQuery ( array $params = [] )
- Retrieves the status of a specified query.
- ListExportTasks ( array $params = [] )
- Retrieves a list of export tasks.
- ListGraphSnapshots ( array $params = [] )
- Lists available snapshots of a specified Neptune Analytics graph.
- ListGraphs ( array $params = [] )
- Lists available Neptune Analytics graphs.
- ListImportTasks ( array $params = [] )
- Lists import tasks.
- ListPrivateGraphEndpoints ( array $params = [] )
- Lists private endpoints for a specified Neptune Analytics graph.
- ListQueries ( array $params = [] )
- Lists active openCypher queries.
- ListTagsForResource ( array $params = [] )
- Lists tags associated with a specified resource.
- ResetGraph ( array $params = [] )
- Empties the data from a specified Neptune Analytics graph.
- RestoreGraphFromSnapshot ( array $params = [] )
- Restores a graph from a snapshot.
- StartExportTask ( array $params = [] )
- Export data from an existing Neptune Analytics graph to Amazon S3.
- StartImportTask ( array $params = [] )
- Import data into existing Neptune Analytics graph from Amazon Simple Storage Service (S3).
- TagResource ( array $params = [] )
- Adds tags to the specified resource.
- UntagResource ( array $params = [] )
- Removes the specified tags from the specified resource.
- UpdateGraph ( array $params = [] )
- Updates the configuration of a specified Neptune Analytics graph
Paginators
Paginators handle automatically iterating over paginated API results. Paginators are associated with specific API operations, and they accept the parameters that the corresponding API operation accepts. You can get a paginator from a client class using getPaginator($paginatorName, $operationParameters). This client supports the following paginators:
Waiters
Waiters allow you to poll a resource until it enters into a desired state. A waiter has a name used to describe what it does, and is associated with an API operation. When creating a waiter, you can provide the API operation parameters associated with the corresponding operation. Waiters can be accessed using the getWaiter($waiterName, $operationParameters) method of a client object. This client supports the following waiters:
Waiter name | API Operation | Delay | Max Attempts |
---|---|---|---|
ExportTaskCancelled | GetExportTask | 60 | 60 |
ExportTaskSuccessful | GetExportTask | 60 | 480 |
GraphAvailable | GetGraph | 60 | 480 |
GraphDeleted | GetGraph | 60 | 60 |
GraphSnapshotAvailable | GetGraphSnapshot | 60 | 120 |
GraphSnapshotDeleted | GetGraphSnapshot | 60 | 60 |
ImportTaskCancelled | GetImportTask | 60 | 60 |
ImportTaskSuccessful | GetImportTask | 60 | 480 |
PrivateGraphEndpointAvailable | GetPrivateGraphEndpoint | 10 | 180 |
PrivateGraphEndpointDeleted | GetPrivateGraphEndpoint | 10 | 180 |
Operations
CancelExportTask
$result = $client->cancelExportTask
([/* ... */]); $promise = $client->cancelExportTaskAsync
([/* ... */]);
Cancel the specified export task.
Parameter Syntax
$result = $client->cancelExportTask([ 'taskIdentifier' => '<string>', // REQUIRED ]);
Parameter Details
Members
- taskIdentifier
-
- Required: Yes
- Type: string
The unique identifier of the export task.
Result Syntax
[ 'destination' => '<string>', 'format' => 'PARQUET|CSV', 'graphId' => '<string>', 'kmsKeyIdentifier' => '<string>', 'parquetType' => 'COLUMNAR', 'roleArn' => '<string>', 'status' => 'INITIALIZING|EXPORTING|SUCCEEDED|FAILED|CANCELLING|CANCELLED|DELETED', 'statusReason' => '<string>', 'taskId' => '<string>', ]
Result Details
Members
- destination
-
- Required: Yes
- Type: string
The Amazon S3 URI of the cancelled export task where data will be exported to.
- format
-
- Required: Yes
- Type: string
The format of the cancelled export task.
- graphId
-
- Required: Yes
- Type: string
The source graph identifier of the cancelled export task.
- kmsKeyIdentifier
-
- Required: Yes
- Type: string
The KMS key identifier of the cancelled export task.
- parquetType
-
- Type: string
The parquet type of the cancelled export task.
- roleArn
-
- Required: Yes
- Type: string
The ARN of the IAM role that will allow the exporting of data to the destination.
- status
-
- Required: Yes
- Type: string
The current status of the export task. The status is
CANCELLING
when the export task is cancelled. - statusReason
-
- Type: string
The reason that the export task has this status value.
- taskId
-
- Required: Yes
- Type: string
The unique identifier of the export task.
Errors
- ThrottlingException:
The exception was interrupted by throttling.
- ValidationException:
A resource could not be validated.
- ConflictException:
Raised when a conflict is encountered.
- InternalServerException:
A failure occurred on the server.
- ResourceNotFoundException:
A specified resource could not be located.
CancelImportTask
$result = $client->cancelImportTask
([/* ... */]); $promise = $client->cancelImportTaskAsync
([/* ... */]);
Deletes the specified import task.
Parameter Syntax
$result = $client->cancelImportTask([ 'taskIdentifier' => '<string>', // REQUIRED ]);
Parameter Details
Members
- taskIdentifier
-
- Required: Yes
- Type: string
The unique identifier of the import task.
Result Syntax
[ 'format' => 'CSV|OPEN_CYPHER|PARQUET|NTRIPLES', 'graphId' => '<string>', 'parquetType' => 'COLUMNAR', 'roleArn' => '<string>', 'source' => '<string>', 'status' => 'INITIALIZING|EXPORTING|ANALYZING_DATA|IMPORTING|REPROVISIONING|ROLLING_BACK|SUCCEEDED|FAILED|CANCELLING|CANCELLED|DELETED', 'taskId' => '<string>', ]
Result Details
Members
- format
-
- Type: string
Specifies the format of S3 data to be imported. Valid values are
CSV
, which identifies the Gremlin CSV format orOPENCYPHER
, which identies the openCypher load format. - graphId
-
- Type: string
The unique identifier of the Neptune Analytics graph.
- parquetType
-
- Type: string
The parquet type of the cancelled import task.
- roleArn
-
- Required: Yes
- Type: string
The ARN of the IAM role that will allow access to the data that is to be imported.
- source
-
- Required: Yes
- Type: string
A URL identifying to the location of the data to be imported. This can be an Amazon S3 path, or can point to a Neptune database endpoint or snapshot.
- status
-
- Required: Yes
- Type: string
Current status of the task. Status is CANCELLING when the import task is cancelled.
- taskId
-
- Required: Yes
- Type: string
The unique identifier of the import task.
Errors
- ThrottlingException:
The exception was interrupted by throttling.
- ValidationException:
A resource could not be validated.
- ConflictException:
Raised when a conflict is encountered.
- InternalServerException:
A failure occurred on the server.
- ResourceNotFoundException:
A specified resource could not be located.
CancelQuery
$result = $client->cancelQuery
([/* ... */]); $promise = $client->cancelQueryAsync
([/* ... */]);
Cancels a specified query.
Parameter Syntax
$result = $client->cancelQuery([ 'graphIdentifier' => '<string>', // REQUIRED 'queryId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- graphIdentifier
-
- Required: Yes
- Type: string
The unique identifier of the Neptune Analytics graph.
- queryId
-
- Required: Yes
- Type: string
The unique identifier of the query to cancel.
Result Syntax
[]
Result Details
Errors
- ThrottlingException:
The exception was interrupted by throttling.
- ValidationException:
A resource could not be validated.
- AccessDeniedException:
Raised in case of an authentication or authorization failure.
- InternalServerException:
A failure occurred on the server.
- ResourceNotFoundException:
A specified resource could not be located.
CreateGraph
$result = $client->createGraph
([/* ... */]); $promise = $client->createGraphAsync
([/* ... */]);
Creates a new Neptune Analytics graph.
Parameter Syntax
$result = $client->createGraph([ 'deletionProtection' => true || false, 'graphName' => '<string>', // REQUIRED 'kmsKeyIdentifier' => '<string>', 'provisionedMemory' => <integer>, // REQUIRED 'publicConnectivity' => true || false, 'replicaCount' => <integer>, 'tags' => ['<string>', ...], 'vectorSearchConfiguration' => [ 'dimension' => <integer>, // REQUIRED ], ]);
Parameter Details
Members
- deletionProtection
-
- Type: boolean
Indicates whether or not to enable deletion protection on the graph. The graph can’t be deleted when deletion protection is enabled. (
true
orfalse
). - graphName
-
- Required: Yes
- Type: string
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.
- kmsKeyIdentifier
-
- Type: string
Specifies a KMS key to use to encrypt data in the new graph.
- provisionedMemory
-
- Required: Yes
- Type: int
The provisioned memory-optimized Neptune Capacity Units (m-NCUs) to use for the graph. Min = 128
- publicConnectivity
-
- Type: boolean
Specifies whether or not the graph can be reachable over the internet. All access to graphs is IAM authenticated. (
true
to enable, orfalse
to disable. - replicaCount
-
- Type: int
The number of replicas in other AZs. Min =0, Max = 2, Default = 1.
Additional charges equivalent to the m-NCUs selected for the graph apply for each replica.
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
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.
- vectorSearchConfiguration
-
- Type: VectorSearchConfiguration structure
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
Result Syntax
[ 'arn' => '<string>', 'buildNumber' => '<string>', 'createTime' => <DateTime>, 'deletionProtection' => true || false, 'endpoint' => '<string>', 'id' => '<string>', 'kmsKeyIdentifier' => '<string>', 'name' => '<string>', 'provisionedMemory' => <integer>, 'publicConnectivity' => true || false, 'replicaCount' => <integer>, 'sourceSnapshotId' => '<string>', 'status' => 'CREATING|AVAILABLE|DELETING|RESETTING|UPDATING|SNAPSHOTTING|FAILED|IMPORTING', 'statusReason' => '<string>', 'vectorSearchConfiguration' => [ 'dimension' => <integer>, ], ]
Result Details
Members
- arn
-
- Required: Yes
- Type: string
The ARN of the graph.
- buildNumber
-
- Type: string
The build number of the graph software.
- createTime
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time when the graph was created.
- deletionProtection
-
- Type: boolean
A value that indicates whether the graph has deletion protection enabled. The graph can't be deleted when deletion protection is enabled.
- endpoint
-
- Type: string
The graph endpoint.
- id
-
- Required: Yes
- Type: string
The ID of the graph.
- kmsKeyIdentifier
-
- Type: string
Specifies the KMS key used to encrypt data in the new graph.
- name
-
- Required: Yes
- Type: 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.
- provisionedMemory
-
- Type: int
The provisioned memory-optimized Neptune Capacity Units (m-NCUs) to use for the graph.
Min = 128
- publicConnectivity
-
- Type: boolean
Specifies whether or not the graph can be reachable over the internet. All access to graphs is IAM authenticated.
If enabling public connectivity for the first time, there will be a delay while it is enabled.
- replicaCount
-
- Type: int
The number of replicas in other AZs.
Default: If not specified, the default value is 1.
- sourceSnapshotId
-
- Type: string
The ID of the source graph.
- status
-
- Type: string
The current status of the graph.
- statusReason
-
- Type: string
The reason the status was given.
- vectorSearchConfiguration
-
- Type: VectorSearchConfiguration structure
The vector-search configuration for the graph, which specifies the vector dimension to use in the vector index, if any.
Errors
- ServiceQuotaExceededException:
A service quota was exceeded.
- ThrottlingException:
The exception was interrupted by throttling.
- ValidationException:
A resource could not be validated.
- ConflictException:
Raised when a conflict is encountered.
- InternalServerException:
A failure occurred on the server.
CreateGraphSnapshot
$result = $client->createGraphSnapshot
([/* ... */]); $promise = $client->createGraphSnapshotAsync
([/* ... */]);
Creates a snapshot of the specific graph.
Parameter Syntax
$result = $client->createGraphSnapshot([ 'graphIdentifier' => '<string>', // REQUIRED 'snapshotName' => '<string>', // REQUIRED 'tags' => ['<string>', ...], ]);
Parameter Details
Members
- graphIdentifier
-
- Required: Yes
- Type: string
The unique identifier of the Neptune Analytics graph.
- snapshotName
-
- Required: Yes
- Type: string
The snapshot name. For example:
my-snapshot-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.
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
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.
Result Syntax
[ 'arn' => '<string>', 'id' => '<string>', 'kmsKeyIdentifier' => '<string>', 'name' => '<string>', 'snapshotCreateTime' => <DateTime>, 'sourceGraphId' => '<string>', 'status' => 'CREATING|AVAILABLE|DELETING|FAILED', ]
Result Details
Members
- arn
-
- Required: Yes
- Type: string
The ARN of the snapshot created.
- id
-
- Required: Yes
- Type: string
The ID of the snapshot created.
- kmsKeyIdentifier
-
- Type: string
The ID of the KMS key used to encrypt and decrypt graph data.
- name
-
- Required: Yes
- Type: string
The name of the snapshot created.
- snapshotCreateTime
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The snapshot creation time
- sourceGraphId
-
- Type: string
The Id of the Neptune Analytics graph from which the snapshot is created.
- status
-
- Type: string
The current state of the snapshot.
Errors
- ServiceQuotaExceededException:
A service quota was exceeded.
- ThrottlingException:
The exception was interrupted by throttling.
- ValidationException:
A resource could not be validated.
- ConflictException:
Raised when a conflict is encountered.
- InternalServerException:
A failure occurred on the server.
- ResourceNotFoundException:
A specified resource could not be located.
CreateGraphUsingImportTask
$result = $client->createGraphUsingImportTask
([/* ... */]); $promise = $client->createGraphUsingImportTaskAsync
([/* ... */]);
Creates a new Neptune Analytics graph and imports data into it, either from Amazon Simple Storage Service (S3) or from a Neptune database or a Neptune database snapshot.
The data can be loaded from files in S3 that in either the Gremlin CSV format or the openCypher load format.
Parameter Syntax
$result = $client->createGraphUsingImportTask([ 'blankNodeHandling' => 'convertToIri', 'deletionProtection' => true || false, 'failOnError' => true || false, 'format' => 'CSV|OPEN_CYPHER|PARQUET|NTRIPLES', 'graphName' => '<string>', // REQUIRED 'importOptions' => [ 'neptune' => [ 'preserveDefaultVertexLabels' => true || false, 'preserveEdgeIds' => true || false, 's3ExportKmsKeyId' => '<string>', // REQUIRED 's3ExportPath' => '<string>', // REQUIRED ], ], 'kmsKeyIdentifier' => '<string>', 'maxProvisionedMemory' => <integer>, 'minProvisionedMemory' => <integer>, 'parquetType' => 'COLUMNAR', 'publicConnectivity' => true || false, 'replicaCount' => <integer>, 'roleArn' => '<string>', // REQUIRED 'source' => '<string>', // REQUIRED 'tags' => ['<string>', ...], 'vectorSearchConfiguration' => [ 'dimension' => <integer>, // REQUIRED ], ]);
Parameter Details
Members
- blankNodeHandling
-
- Type: string
The method to handle blank nodes in the dataset. Currently, only
convertToIri
is supported, meaning blank nodes are converted to unique IRIs at load time. Must be provided when format isntriples
. For more information, see Handling RDF values. - deletionProtection
-
- Type: boolean
Indicates whether or not to enable deletion protection on the graph. The graph can’t be deleted when deletion protection is enabled. (
true
orfalse
). - failOnError
-
- Type: boolean
If set to
true
, the task halts when an import error is encountered. If set tofalse
, the task skips the data that caused the error and continues if possible. - format
-
- Type: string
Specifies the format of S3 data to be imported. Valid values are
CSV
, which identifies the Gremlin CSV format,OPEN_CYPHER
, which identifies the openCypher load format, orntriples
, which identifies the RDF n-triples format. - graphName
-
- Required: Yes
- Type: string
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.
- importOptions
-
- Type: ImportOptions structure
Contains options for controlling the import process. For example, if the
failOnError
key is set tofalse
, the import skips problem data and attempts to continue (whereas if set totrue
, the default, or if omitted, the import operation halts immediately when an error is encountered. - kmsKeyIdentifier
-
- Type: string
Specifies a KMS key to use to encrypt data imported into the new graph.
- maxProvisionedMemory
-
- Type: int
The maximum provisioned memory-optimized Neptune Capacity Units (m-NCUs) to use for the graph. Default: 1024, or the approved upper limit for your account.
If both the minimum and maximum values are specified, the max of the
min-provisioned-memory
andmax-provisioned memory
is used to create the graph. If neither value is specified 128 m-NCUs are used. - minProvisionedMemory
-
- Type: int
The minimum provisioned memory-optimized Neptune Capacity Units (m-NCUs) to use for the graph. Default: 128
- parquetType
-
- Type: string
The parquet type of the import task.
- publicConnectivity
-
- Type: boolean
Specifies whether or not the graph can be reachable over the internet. All access to graphs is IAM authenticated. (
true
to enable, orfalse
to disable). - replicaCount
-
- Type: int
The number of replicas in other AZs to provision on the new graph after import. Default = 0, Min = 0, Max = 2.
Additional charges equivalent to the m-NCUs selected for the graph apply for each replica.
- roleArn
-
- Required: Yes
- Type: string
The ARN of the IAM role that will allow access to the data that is to be imported.
- source
-
- Required: Yes
- Type: string
A URL identifying to the location of the data to be imported. This can be an Amazon S3 path, or can point to a Neptune database endpoint or snapshot.
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
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.
- vectorSearchConfiguration
-
- Type: VectorSearchConfiguration structure
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
Result Syntax
[ 'format' => 'CSV|OPEN_CYPHER|PARQUET|NTRIPLES', 'graphId' => '<string>', 'importOptions' => [ 'neptune' => [ 'preserveDefaultVertexLabels' => true || false, 'preserveEdgeIds' => true || false, 's3ExportKmsKeyId' => '<string>', 's3ExportPath' => '<string>', ], ], 'parquetType' => 'COLUMNAR', 'roleArn' => '<string>', 'source' => '<string>', 'status' => 'INITIALIZING|EXPORTING|ANALYZING_DATA|IMPORTING|REPROVISIONING|ROLLING_BACK|SUCCEEDED|FAILED|CANCELLING|CANCELLED|DELETED', 'taskId' => '<string>', ]
Result Details
Members
- format
-
- Type: string
Specifies the format of S3 data to be imported. Valid values are
CSV
, which identifies the Gremlin CSV format,OPENCYPHER
, which identifies the openCypher load format, orntriples
, which identifies the RDF n-triples format. - graphId
-
- Type: string
The unique identifier of the Neptune Analytics graph.
- importOptions
-
- Type: ImportOptions structure
Contains options for controlling the import process. For example, if the
failOnError
key is set tofalse
, the import skips problem data and attempts to continue (whereas if set totrue
, the default, or if omitted, the import operation halts immediately when an error is encountered. - parquetType
-
- Type: string
The parquet type of the import task.
- roleArn
-
- Required: Yes
- Type: string
The ARN of the IAM role that will allow access to the data that is to be imported.
- source
-
- Required: Yes
- Type: string
A URL identifying to the location of the data to be imported. This can be an Amazon S3 path, or can point to a Neptune database endpoint or snapshot.
- status
-
- Required: Yes
- Type: string
The status of the import task.
- taskId
-
- Required: Yes
- Type: string
The unique identifier of the import task.
Errors
- ServiceQuotaExceededException:
A service quota was exceeded.
- ThrottlingException:
The exception was interrupted by throttling.
- ValidationException:
A resource could not be validated.
- ConflictException:
Raised when a conflict is encountered.
- InternalServerException:
A failure occurred on the server.
CreatePrivateGraphEndpoint
$result = $client->createPrivateGraphEndpoint
([/* ... */]); $promise = $client->createPrivateGraphEndpointAsync
([/* ... */]);
Create a private graph endpoint to allow private access from to the graph from within a VPC. You can attach security groups to the private graph endpoint.
VPC endpoint charges apply.
Parameter Syntax
$result = $client->createPrivateGraphEndpoint([ 'graphIdentifier' => '<string>', // REQUIRED 'subnetIds' => ['<string>', ...], 'vpcId' => '<string>', 'vpcSecurityGroupIds' => ['<string>', ...], ]);
Parameter Details
Members
- graphIdentifier
-
- Required: Yes
- Type: string
The unique identifier of the Neptune Analytics graph.
- subnetIds
-
- Type: Array of strings
Subnets in which private graph endpoint ENIs are created.
- vpcId
-
- Type: string
The VPC in which the private graph endpoint needs to be created.
- vpcSecurityGroupIds
-
- Type: Array of strings
Security groups to be attached to the private graph endpoint..
Result Syntax
[ 'status' => 'CREATING|AVAILABLE|DELETING|FAILED', 'subnetIds' => ['<string>', ...], 'vpcEndpointId' => '<string>', 'vpcId' => '<string>', ]
Result Details
Members
- status
-
- Required: Yes
- Type: string
Status of the private graph endpoint.
- subnetIds
-
- Required: Yes
- Type: Array of strings
Subnets in which the private graph endpoint ENIs are created.
- vpcEndpointId
-
- Type: string
Endpoint ID of the prviate grpah endpoint.
- vpcId
-
- Required: Yes
- Type: string
VPC in which the private graph endpoint is created.
Errors
- ServiceQuotaExceededException:
A service quota was exceeded.
- ThrottlingException:
The exception was interrupted by throttling.
- ValidationException:
A resource could not be validated.
- ConflictException:
Raised when a conflict is encountered.
- InternalServerException:
A failure occurred on the server.
- ResourceNotFoundException:
A specified resource could not be located.
DeleteGraph
$result = $client->deleteGraph
([/* ... */]); $promise = $client->deleteGraphAsync
([/* ... */]);
Deletes the specified graph. Graphs cannot be deleted if delete-protection is enabled.
Parameter Syntax
$result = $client->deleteGraph([ 'graphIdentifier' => '<string>', // REQUIRED 'skipSnapshot' => true || false, // REQUIRED ]);
Parameter Details
Members
- graphIdentifier
-
- Required: Yes
- Type: string
The unique identifier of the Neptune Analytics graph.
- skipSnapshot
-
- Required: Yes
- Type: boolean
Determines whether a final graph snapshot is created before the graph is deleted. If
true
is specified, no graph snapshot is created. Iffalse
is specified, a graph snapshot is created before the graph is deleted.
Result Syntax
[ 'arn' => '<string>', 'buildNumber' => '<string>', 'createTime' => <DateTime>, 'deletionProtection' => true || false, 'endpoint' => '<string>', 'id' => '<string>', 'kmsKeyIdentifier' => '<string>', 'name' => '<string>', 'provisionedMemory' => <integer>, 'publicConnectivity' => true || false, 'replicaCount' => <integer>, 'sourceSnapshotId' => '<string>', 'status' => 'CREATING|AVAILABLE|DELETING|RESETTING|UPDATING|SNAPSHOTTING|FAILED|IMPORTING', 'statusReason' => '<string>', 'vectorSearchConfiguration' => [ 'dimension' => <integer>, ], ]
Result Details
Members
- arn
-
- Required: Yes
- Type: string
The ARN associated with the graph.
- buildNumber
-
- Type: string
The build number associated with the graph.
- createTime
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time at which the graph was created.
- deletionProtection
-
- Type: boolean
If
true
, deletion protection was enabled for the graph. - endpoint
-
- Type: string
The graph endpoint.
- id
-
- Required: Yes
- Type: string
The unique identifier of the graph.
- kmsKeyIdentifier
-
- Type: string
The ID of the KMS key used to encrypt and decrypt graph data.
- name
-
- Required: Yes
- Type: string
The name of the graph.
- provisionedMemory
-
- Type: int
The number of memory-optimized Neptune Capacity Units (m-NCUs) allocated to the graph.
- publicConnectivity
-
- Type: boolean
If
true
, the graph has a public endpoint, otherwise not. - replicaCount
-
- Type: int
The number of replicas for the graph.
- sourceSnapshotId
-
- Type: string
The ID of the snapshot from which the graph was created, if the graph was recovered from a snapshot.
- status
-
- Type: string
The status of the graph.
- statusReason
-
- Type: string
The reason for the status of the graph.
- vectorSearchConfiguration
-
- Type: VectorSearchConfiguration structure
Specifies the number of dimensions for vector embeddings loaded into the graph. Max = 65535
Errors
- ThrottlingException:
The exception was interrupted by throttling.
- ValidationException:
A resource could not be validated.
- ConflictException:
Raised when a conflict is encountered.
- InternalServerException:
A failure occurred on the server.
- ResourceNotFoundException:
A specified resource could not be located.
DeleteGraphSnapshot
$result = $client->deleteGraphSnapshot
([/* ... */]); $promise = $client->deleteGraphSnapshotAsync
([/* ... */]);
Deletes the specifed graph snapshot.
Parameter Syntax
$result = $client->deleteGraphSnapshot([ 'snapshotIdentifier' => '<string>', // REQUIRED ]);
Parameter Details
Members
- snapshotIdentifier
-
- Required: Yes
- Type: string
ID of the graph snapshot to be deleted.
Result Syntax
[ 'arn' => '<string>', 'id' => '<string>', 'kmsKeyIdentifier' => '<string>', 'name' => '<string>', 'snapshotCreateTime' => <DateTime>, 'sourceGraphId' => '<string>', 'status' => 'CREATING|AVAILABLE|DELETING|FAILED', ]
Result Details
Members
- arn
-
- Required: Yes
- Type: string
The ARN of the graph snapshot.
- id
-
- Required: Yes
- Type: string
The unique identifier of the graph snapshot.
- kmsKeyIdentifier
-
- Type: string
The ID of the KMS key used to encrypt and decrypt the snapshot.
- name
-
- Required: Yes
- Type: string
The snapshot name. For example:
my-snapshot-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.
- snapshotCreateTime
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time when the snapshot was created.
- sourceGraphId
-
- Type: string
The graph identifier for the graph from which the snapshot was created.
- status
-
- Type: string
The status of the graph snapshot.
Errors
- ThrottlingException:
The exception was interrupted by throttling.
- ValidationException:
A resource could not be validated.
- ConflictException:
Raised when a conflict is encountered.
- InternalServerException:
A failure occurred on the server.
- ResourceNotFoundException:
A specified resource could not be located.
DeletePrivateGraphEndpoint
$result = $client->deletePrivateGraphEndpoint
([/* ... */]); $promise = $client->deletePrivateGraphEndpointAsync
([/* ... */]);
Deletes a private graph endpoint.
Parameter Syntax
$result = $client->deletePrivateGraphEndpoint([ 'graphIdentifier' => '<string>', // REQUIRED 'vpcId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- graphIdentifier
-
- Required: Yes
- Type: string
The unique identifier of the Neptune Analytics graph.
- vpcId
-
- Required: Yes
- Type: string
The ID of the VPC where the private endpoint is located.
Result Syntax
[ 'status' => 'CREATING|AVAILABLE|DELETING|FAILED', 'subnetIds' => ['<string>', ...], 'vpcEndpointId' => '<string>', 'vpcId' => '<string>', ]
Result Details
Members
- status
-
- Required: Yes
- Type: string
The status of the delete operation.
- subnetIds
-
- Required: Yes
- Type: Array of strings
The subnet IDs involved.
- vpcEndpointId
-
- Type: string
The ID of the VPC endpoint that was deleted.
- vpcId
-
- Required: Yes
- Type: string
The ID of the VPC where the private endpoint was deleted.
Errors
- ThrottlingException:
The exception was interrupted by throttling.
- ValidationException:
A resource could not be validated.
- ConflictException:
Raised when a conflict is encountered.
- InternalServerException:
A failure occurred on the server.
- ResourceNotFoundException:
A specified resource could not be located.
ExecuteQuery
$result = $client->executeQuery
([/* ... */]); $promise = $client->executeQueryAsync
([/* ... */]);
Execute an openCypher query.
When invoking this operation in a Neptune Analytics cluster, the IAM user or role making the request must have a policy attached that allows one of the following IAM actions in that cluster, depending on the query:
-
neptune-graph:ReadDataViaQuery
-
neptune-graph:WriteDataViaQuery
-
neptune-graph:DeleteDataViaQuery
Parameter Syntax
$result = $client->executeQuery([ 'explainMode' => 'STATIC|DETAILS', 'graphIdentifier' => '<string>', // REQUIRED 'language' => 'OPEN_CYPHER', // REQUIRED 'parameters' => [ '<String>' => [ ], // ... ], 'planCache' => 'ENABLED|DISABLED|AUTO', 'queryString' => '<string>', // REQUIRED 'queryTimeoutMilliseconds' => <integer>, ]);
Parameter Details
Members
- explainMode
-
- Type: string
The explain mode parameter returns a query explain instead of the actual query results. A query explain can be used to gather insights about the query execution such as planning decisions, time spent on each operator, solutions flowing etc.
- graphIdentifier
-
- Required: Yes
- Type: string
The unique identifier of the Neptune Analytics graph.
- language
-
- Required: Yes
- Type: string
The query language the query is written in. Currently only openCypher is supported.
- parameters
-
- Type: Associative array of custom strings keys (String) to document (null|bool|string|numeric) or an (array|associative array) whose members are all valid documentss
The data parameters the query can use in JSON format. For example: {"name": "john", "age": 20}. (optional)
- planCache
-
- Type: string
Query plan cache is a feature that saves the query plan and reuses it on successive executions of the same query. This reduces query latency, and works for both
READ
andUPDATE
queries. The plan cache is an LRU cache with a 5 minute TTL and a capacity of 1000. - queryString
-
- Required: Yes
- Type: string
The query string to be executed.
- queryTimeoutMilliseconds
-
- Type: int
Specifies the query timeout duration, in milliseconds. (optional)
Result Syntax
[ 'payload' => <string || resource || Psr\Http\Message\StreamInterface>, ]
Result Details
Members
- payload
-
- Required: Yes
- Type: blob (string|resource|Psr\Http\Message\StreamInterface)
The query results.
Errors
- UnprocessableException:
Request cannot be processed due to known reasons. Eg. partition full.
- ThrottlingException:
The exception was interrupted by throttling.
- ValidationException:
A resource could not be validated.
- ConflictException:
Raised when a conflict is encountered.
- AccessDeniedException:
Raised in case of an authentication or authorization failure.
- InternalServerException:
A failure occurred on the server.
GetExportTask
$result = $client->getExportTask
([/* ... */]); $promise = $client->getExportTaskAsync
([/* ... */]);
Retrieves a specified export task.
Parameter Syntax
$result = $client->getExportTask([ 'taskIdentifier' => '<string>', // REQUIRED ]);
Parameter Details
Members
- taskIdentifier
-
- Required: Yes
- Type: string
The unique identifier of the export task.
Result Syntax
[ 'destination' => '<string>', 'exportFilter' => [ 'edgeFilter' => [ '<ExportFilterLabel>' => [ 'properties' => [ '<ExportFilterOutputPropertyName>' => [ 'multiValueHandling' => 'TO_LIST|PICK_FIRST', 'outputType' => '<string>', 'sourcePropertyName' => '<string>', ], // ... ], ], // ... ], 'vertexFilter' => [ '<ExportFilterLabel>' => [ 'properties' => [ '<ExportFilterOutputPropertyName>' => [ 'multiValueHandling' => 'TO_LIST|PICK_FIRST', 'outputType' => '<string>', 'sourcePropertyName' => '<string>', ], // ... ], ], // ... ], ], 'exportTaskDetails' => [ 'numEdgesWritten' => <integer>, 'numVerticesWritten' => <integer>, 'progressPercentage' => <integer>, 'startTime' => <DateTime>, 'timeElapsedSeconds' => <integer>, ], 'format' => 'PARQUET|CSV', 'graphId' => '<string>', 'kmsKeyIdentifier' => '<string>', 'parquetType' => 'COLUMNAR', 'roleArn' => '<string>', 'status' => 'INITIALIZING|EXPORTING|SUCCEEDED|FAILED|CANCELLING|CANCELLED|DELETED', 'statusReason' => '<string>', 'taskId' => '<string>', ]
Result Details
Members
- destination
-
- Required: Yes
- Type: string
The Amazon S3 URI of the export task where data will be exported.
- exportFilter
-
- Type: ExportFilter structure
The export filter of the export task.
- exportTaskDetails
-
- Type: ExportTaskDetails structure
The details of the export task.
- format
-
- Required: Yes
- Type: string
The format of the export task.
- graphId
-
- Required: Yes
- Type: string
The source graph identifier of the export task.
- kmsKeyIdentifier
-
- Required: Yes
- Type: string
The KMS key identifier of the export task.
- parquetType
-
- Type: string
The parquet type of the export task.
- roleArn
-
- Required: Yes
- Type: string
The ARN of the IAM role that will allow data to be exported to the destination.
- status
-
- Required: Yes
- Type: string
The current status of the export task.
- statusReason
-
- Type: string
The reason that the export task has this status value.
- taskId
-
- Required: Yes
- Type: string
The unique identifier of the export task.
Errors
- ThrottlingException:
The exception was interrupted by throttling.
- ValidationException:
A resource could not be validated.
- InternalServerException:
A failure occurred on the server.
- ResourceNotFoundException:
A specified resource could not be located.
GetGraph
$result = $client->getGraph
([/* ... */]); $promise = $client->getGraphAsync
([/* ... */]);
Gets information about a specified graph.
Parameter Syntax
$result = $client->getGraph([ 'graphIdentifier' => '<string>', // REQUIRED ]);
Parameter Details
Members
- graphIdentifier
-
- Required: Yes
- Type: string
The unique identifier of the Neptune Analytics graph.
Result Syntax
[ 'arn' => '<string>', 'buildNumber' => '<string>', 'createTime' => <DateTime>, 'deletionProtection' => true || false, 'endpoint' => '<string>', 'id' => '<string>', 'kmsKeyIdentifier' => '<string>', 'name' => '<string>', 'provisionedMemory' => <integer>, 'publicConnectivity' => true || false, 'replicaCount' => <integer>, 'sourceSnapshotId' => '<string>', 'status' => 'CREATING|AVAILABLE|DELETING|RESETTING|UPDATING|SNAPSHOTTING|FAILED|IMPORTING', 'statusReason' => '<string>', 'vectorSearchConfiguration' => [ 'dimension' => <integer>, ], ]
Result Details
Members
- arn
-
- Required: Yes
- Type: string
The ARN associated with the graph.
- buildNumber
-
- Type: string
The build number of the graph.
- createTime
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time at which the graph was created.
- deletionProtection
-
- Type: boolean
If
true
, deletion protection is enabled for the graph. - endpoint
-
- Type: string
The graph endpoint.
- id
-
- Required: Yes
- Type: string
The unique identifier of the graph.
- kmsKeyIdentifier
-
- Type: string
The ID of the KMS key used to encrypt and decrypt graph data.
- name
-
- Required: Yes
- Type: string
The name of the graph.
- provisionedMemory
-
- Type: int
The number of memory-optimized Neptune Capacity Units (m-NCUs) allocated to the graph.
- publicConnectivity
-
- Type: boolean
If
true
, the graph has a public endpoint, otherwise not. - replicaCount
-
- Type: int
The number of replicas for the graph.
- sourceSnapshotId
-
- Type: string
The ID of the snapshot from which the graph was created, if it was created from a snapshot.
- status
-
- Type: string
The status of the graph.
- statusReason
-
- Type: string
The reason that the graph has this status.
- vectorSearchConfiguration
-
- Type: VectorSearchConfiguration structure
Specifies the number of dimensions for vector embeddings loaded into the graph. Max = 65535
Errors
- ThrottlingException:
The exception was interrupted by throttling.
- ValidationException:
A resource could not be validated.
- InternalServerException:
A failure occurred on the server.
- ResourceNotFoundException:
A specified resource could not be located.
GetGraphSnapshot
$result = $client->getGraphSnapshot
([/* ... */]); $promise = $client->getGraphSnapshotAsync
([/* ... */]);
Retrieves a specified graph snapshot.
Parameter Syntax
$result = $client->getGraphSnapshot([ 'snapshotIdentifier' => '<string>', // REQUIRED ]);
Parameter Details
Members
- snapshotIdentifier
-
- Required: Yes
- Type: string
The ID of the snapshot to retrieve.
Result Syntax
[ 'arn' => '<string>', 'id' => '<string>', 'kmsKeyIdentifier' => '<string>', 'name' => '<string>', 'snapshotCreateTime' => <DateTime>, 'sourceGraphId' => '<string>', 'status' => 'CREATING|AVAILABLE|DELETING|FAILED', ]
Result Details
Members
- arn
-
- Required: Yes
- Type: string
The ARN of the graph snapshot.
- id
-
- Required: Yes
- Type: string
The unique identifier of the graph snapshot.
- kmsKeyIdentifier
-
- Type: string
The ID of the KMS key used to encrypt and decrypt the snapshot.
- name
-
- Required: Yes
- Type: string
The snapshot name. For example:
my-snapshot-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.
- snapshotCreateTime
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time when the snapshot was created.
- sourceGraphId
-
- Type: string
The graph identifier for the graph for which a snapshot is to be created.
- status
-
- Type: string
The status of the graph snapshot.
Errors
- ThrottlingException:
The exception was interrupted by throttling.
- ValidationException:
A resource could not be validated.
- InternalServerException:
A failure occurred on the server.
- ResourceNotFoundException:
A specified resource could not be located.
GetGraphSummary
$result = $client->getGraphSummary
([/* ... */]); $promise = $client->getGraphSummaryAsync
([/* ... */]);
Gets a graph summary for a property graph.
Parameter Syntax
$result = $client->getGraphSummary([ 'graphIdentifier' => '<string>', // REQUIRED 'mode' => 'BASIC|DETAILED', ]);
Parameter Details
Members
- graphIdentifier
-
- Required: Yes
- Type: string
The unique identifier of the Neptune Analytics graph.
- mode
-
- Type: string
The summary mode can take one of two values:
basic
(the default), anddetailed
.
Result Syntax
[ 'graphSummary' => [ 'edgeLabels' => ['<string>', ...], 'edgeProperties' => [ [<integer>, ...], // ... ], 'edgeStructures' => [ [ 'count' => <integer>, 'edgeProperties' => ['<string>', ...], ], // ... ], 'nodeLabels' => ['<string>', ...], 'nodeProperties' => [ [<integer>, ...], // ... ], 'nodeStructures' => [ [ 'count' => <integer>, 'distinctOutgoingEdgeLabels' => ['<string>', ...], 'nodeProperties' => ['<string>', ...], ], // ... ], 'numEdgeLabels' => <integer>, 'numEdgeProperties' => <integer>, 'numEdges' => <integer>, 'numNodeLabels' => <integer>, 'numNodeProperties' => <integer>, 'numNodes' => <integer>, 'totalEdgePropertyValues' => <integer>, 'totalNodePropertyValues' => <integer>, ], 'lastStatisticsComputationTime' => <DateTime>, 'version' => '<string>', ]
Result Details
Members
- graphSummary
-
- Type: GraphDataSummary structure
The graph summary.
- lastStatisticsComputationTime
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp, in ISO 8601 format, of the time at which Neptune Analytics last computed statistics.
- version
-
- Type: string
Display the version of this tool.
Errors
- ThrottlingException:
The exception was interrupted by throttling.
- ValidationException:
A resource could not be validated.
- AccessDeniedException:
Raised in case of an authentication or authorization failure.
- InternalServerException:
A failure occurred on the server.
- ResourceNotFoundException:
A specified resource could not be located.
GetImportTask
$result = $client->getImportTask
([/* ... */]); $promise = $client->getImportTaskAsync
([/* ... */]);
Retrieves a specified import task.
Parameter Syntax
$result = $client->getImportTask([ 'taskIdentifier' => '<string>', // REQUIRED ]);
Parameter Details
Members
- taskIdentifier
-
- Required: Yes
- Type: string
The unique identifier of the import task.
Result Syntax
[ 'attemptNumber' => <integer>, 'format' => 'CSV|OPEN_CYPHER|PARQUET|NTRIPLES', 'graphId' => '<string>', 'importOptions' => [ 'neptune' => [ 'preserveDefaultVertexLabels' => true || false, 'preserveEdgeIds' => true || false, 's3ExportKmsKeyId' => '<string>', 's3ExportPath' => '<string>', ], ], 'importTaskDetails' => [ 'dictionaryEntryCount' => <integer>, 'errorCount' => <integer>, 'errorDetails' => '<string>', 'progressPercentage' => <integer>, 'startTime' => <DateTime>, 'statementCount' => <integer>, 'status' => '<string>', 'timeElapsedSeconds' => <integer>, ], 'parquetType' => 'COLUMNAR', 'roleArn' => '<string>', 'source' => '<string>', 'status' => 'INITIALIZING|EXPORTING|ANALYZING_DATA|IMPORTING|REPROVISIONING|ROLLING_BACK|SUCCEEDED|FAILED|CANCELLING|CANCELLED|DELETED', 'statusReason' => '<string>', 'taskId' => '<string>', ]
Result Details
Members
- attemptNumber
-
- Type: int
The number of the current attempts to execute the import task.
- format
-
- Type: string
Specifies the format of S3 data to be imported. Valid values are
CSV
, which identifies the Gremlin CSV format orOPENCYPHER
, which identies the openCypher load format. - graphId
-
- Type: string
The unique identifier of the Neptune Analytics graph.
- importOptions
-
- Type: ImportOptions structure
Contains options for controlling the import process. For example, if the
failOnError
key is set tofalse
, the import skips problem data and attempts to continue (whereas if set totrue
, the default, or if omitted, the import operation halts immediately when an error is encountered. - importTaskDetails
-
- Type: ImportTaskDetails structure
Contains details about the specified import task.
- parquetType
-
- Type: string
The parquet type of the import task.
- roleArn
-
- Required: Yes
- Type: string
The ARN of the IAM role that will allow access to the data that is to be imported.
- source
-
- Required: Yes
- Type: string
A URL identifying to the location of the data to be imported. This can be an Amazon S3 path, or can point to a Neptune database endpoint or snapshot
- status
-
- Required: Yes
- Type: string
The status of the import task:
-
INITIALIZING  –  The necessary resources needed to create the graph are being prepared.
-
ANALYZING_DATA  –  The data is being analyzed to determine the optimal infrastructure configuration for the new graph.
-
RE_PROVISIONING  –  The data did not fit into the provisioned graph, so it is being re-provisioned with more capacity.
-
IMPORTING  –  The data is being loaded.
-
ERROR_ENCOUNTERED  –  An error has been encountered while trying to create the graph and import the data.
-
ERROR_ENCOUNTERED_ROLLING_BACK  –  Because of the error that was encountered, the graph is being rolled back and all its resources released.
-
SUCCEEDED  –  Graph creation and data loading succeeded.
-
FAILED  –  Graph creation or data loading failed. When the status is
FAILED
, you can useget-graphs
to get more information about the state of the graph. -
CANCELLING  –  Because you cancelled the import task, cancellation is in progress.
-
CANCELLED  –  You have successfully cancelled the import task.
- statusReason
-
- Type: string
The reason that the import task has this status value.
- taskId
-
- Required: Yes
- Type: string
The unique identifier of the import task.
Errors
- ThrottlingException:
The exception was interrupted by throttling.
- ValidationException:
A resource could not be validated.
- InternalServerException:
A failure occurred on the server.
- ResourceNotFoundException:
A specified resource could not be located.
GetPrivateGraphEndpoint
$result = $client->getPrivateGraphEndpoint
([/* ... */]); $promise = $client->getPrivateGraphEndpointAsync
([/* ... */]);
Retrieves information about a specified private endpoint.
Parameter Syntax
$result = $client->getPrivateGraphEndpoint([ 'graphIdentifier' => '<string>', // REQUIRED 'vpcId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- graphIdentifier
-
- Required: Yes
- Type: string
The unique identifier of the Neptune Analytics graph.
- vpcId
-
- Required: Yes
- Type: string
The ID of the VPC where the private endpoint is located.
Result Syntax
[ 'status' => 'CREATING|AVAILABLE|DELETING|FAILED', 'subnetIds' => ['<string>', ...], 'vpcEndpointId' => '<string>', 'vpcId' => '<string>', ]
Result Details
Members
- status
-
- Required: Yes
- Type: string
The current status of the private endpoint.
- subnetIds
-
- Required: Yes
- Type: Array of strings
The subnet IDs involved.
- vpcEndpointId
-
- Type: string
The ID of the private endpoint.
- vpcId
-
- Required: Yes
- Type: string
The ID of the VPC where the private endpoint is located.
Errors
- ThrottlingException:
The exception was interrupted by throttling.
- ValidationException:
A resource could not be validated.
- InternalServerException:
A failure occurred on the server.
- ResourceNotFoundException:
A specified resource could not be located.
GetQuery
$result = $client->getQuery
([/* ... */]); $promise = $client->getQueryAsync
([/* ... */]);
Retrieves the status of a specified query.
When invoking this operation in a Neptune Analytics cluster, the IAM user or role making the request must have the neptune-graph:GetQueryStatus
IAM action attached.
Parameter Syntax
$result = $client->getQuery([ 'graphIdentifier' => '<string>', // REQUIRED 'queryId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- graphIdentifier
-
- Required: Yes
- Type: string
The unique identifier of the Neptune Analytics graph.
- queryId
-
- Required: Yes
- Type: string
The ID of the query in question.
Result Syntax
[ 'elapsed' => <integer>, 'id' => '<string>', 'queryString' => '<string>', 'state' => 'RUNNING|WAITING|CANCELLING', 'waited' => <integer>, ]
Result Details
Members
- elapsed
-
- Type: int
The number of milliseconds the query has been running.
- id
-
- Type: string
The ID of the query in question.
- queryString
-
- Type: string
The query in question.
- state
-
- Type: string
State of the query.
- waited
-
- Type: int
Indicates how long the query waited, in milliseconds.
Errors
- ThrottlingException:
The exception was interrupted by throttling.
- ValidationException:
A resource could not be validated.
- AccessDeniedException:
Raised in case of an authentication or authorization failure.
- InternalServerException:
A failure occurred on the server.
- ResourceNotFoundException:
A specified resource could not be located.
ListExportTasks
$result = $client->listExportTasks
([/* ... */]); $promise = $client->listExportTasksAsync
([/* ... */]);
Retrieves a list of export tasks.
Parameter Syntax
$result = $client->listExportTasks([ 'maxResults' => <integer>, 'nextToken' => '<string>', ]);
Parameter Details
Members
- maxResults
-
- Type: int
The maximum number of export tasks to return.
- nextToken
-
- Type: string
Pagination token used to paginate input.
Result Syntax
[ 'nextToken' => '<string>', 'tasks' => [ [ 'destination' => '<string>', 'format' => 'PARQUET|CSV', 'graphId' => '<string>', 'kmsKeyIdentifier' => '<string>', 'parquetType' => 'COLUMNAR', 'roleArn' => '<string>', 'status' => 'INITIALIZING|EXPORTING|SUCCEEDED|FAILED|CANCELLING|CANCELLED|DELETED', 'statusReason' => '<string>', 'taskId' => '<string>', ], // ... ], ]
Result Details
Members
- nextToken
-
- Type: string
Pagination token used to paginate output.
- tasks
-
- Required: Yes
- Type: Array of ExportTaskSummary structures
The requested list of export tasks.
Errors
- ThrottlingException:
The exception was interrupted by throttling.
- ValidationException:
A resource could not be validated.
- InternalServerException:
A failure occurred on the server.
- ResourceNotFoundException:
A specified resource could not be located.
ListGraphSnapshots
$result = $client->listGraphSnapshots
([/* ... */]); $promise = $client->listGraphSnapshotsAsync
([/* ... */]);
Lists available snapshots of a specified Neptune Analytics graph.
Parameter Syntax
$result = $client->listGraphSnapshots([ 'graphIdentifier' => '<string>', 'maxResults' => <integer>, 'nextToken' => '<string>', ]);
Parameter Details
Members
- graphIdentifier
-
- Type: string
The unique identifier of the Neptune Analytics graph.
- maxResults
-
- Type: int
The total number of records to return in the command's output.
If the total number of records available is more than the value specified,
nextToken
is provided in the command's output. To resume pagination, provide thenextToken
output value in thenextToken
argument of a subsequent command. Do not use thenextToken
response element directly outside of the Amazon CLI. - nextToken
-
- Type: string
Pagination token used to paginate output.
When this value is provided as input, the service returns results from where the previous response left off. When this value is present in output, it indicates that there are more results to retrieve.
Result Syntax
[ 'graphSnapshots' => [ [ 'arn' => '<string>', 'id' => '<string>', 'kmsKeyIdentifier' => '<string>', 'name' => '<string>', 'snapshotCreateTime' => <DateTime>, 'sourceGraphId' => '<string>', 'status' => 'CREATING|AVAILABLE|DELETING|FAILED', ], // ... ], 'nextToken' => '<string>', ]
Result Details
Members
- graphSnapshots
-
- Required: Yes
- Type: Array of GraphSnapshotSummary structures
The requested list of snapshots.
- nextToken
-
- Type: string
Pagination token used to paginate output.
When this value is provided as input, the service returns results from where the previous response left off. When this value is present in output, it indicates that there are more results to retrieve.
Errors
- ThrottlingException:
The exception was interrupted by throttling.
- ValidationException:
A resource could not be validated.
- InternalServerException:
A failure occurred on the server.
- ResourceNotFoundException:
A specified resource could not be located.
ListGraphs
$result = $client->listGraphs
([/* ... */]); $promise = $client->listGraphsAsync
([/* ... */]);
Lists available Neptune Analytics graphs.
Parameter Syntax
$result = $client->listGraphs([ 'maxResults' => <integer>, 'nextToken' => '<string>', ]);
Parameter Details
Members
- maxResults
-
- Type: int
The total number of records to return in the command's output.
If the total number of records available is more than the value specified,
nextToken
is provided in the command's output. To resume pagination, provide thenextToken
output value in thenextToken
argument of a subsequent command. Do not use thenextToken
response element directly outside of the Amazon CLI. - nextToken
-
- Type: string
Pagination token used to paginate output.
When this value is provided as input, the service returns results from where the previous response left off. When this value is present in output, it indicates that there are more results to retrieve.
Result Syntax
[ 'graphs' => [ [ 'arn' => '<string>', 'deletionProtection' => true || false, 'endpoint' => '<string>', 'id' => '<string>', 'kmsKeyIdentifier' => '<string>', 'name' => '<string>', 'provisionedMemory' => <integer>, 'publicConnectivity' => true || false, 'replicaCount' => <integer>, 'status' => 'CREATING|AVAILABLE|DELETING|RESETTING|UPDATING|SNAPSHOTTING|FAILED|IMPORTING', ], // ... ], 'nextToken' => '<string>', ]
Result Details
Members
- graphs
-
- Required: Yes
- Type: Array of GraphSummary structures
A list of the graphs.
- nextToken
-
- Type: string
Pagination token used to paginate output.
When this value is provided as input, the service returns results from where the previous response left off. When this value is present in output, it indicates that there are more results to retrieve.
Errors
- ThrottlingException:
The exception was interrupted by throttling.
- InternalServerException:
A failure occurred on the server.
- ResourceNotFoundException:
A specified resource could not be located.
ListImportTasks
$result = $client->listImportTasks
([/* ... */]); $promise = $client->listImportTasksAsync
([/* ... */]);
Lists import tasks.
Parameter Syntax
$result = $client->listImportTasks([ 'maxResults' => <integer>, 'nextToken' => '<string>', ]);
Parameter Details
Members
- maxResults
-
- Type: int
The total number of records to return in the command's output.
If the total number of records available is more than the value specified,
nextToken
is provided in the command's output. To resume pagination, provide thenextToken
output value in thenextToken
argument of a subsequent command. Do not use thenextToken
response element directly outside of the Amazon CLI. - nextToken
-
- Type: string
Pagination token used to paginate output.
When this value is provided as input, the service returns results from where the previous response left off. When this value is present in output, it indicates that there are more results to retrieve.
Result Syntax
[ 'nextToken' => '<string>', 'tasks' => [ [ 'format' => 'CSV|OPEN_CYPHER|PARQUET|NTRIPLES', 'graphId' => '<string>', 'parquetType' => 'COLUMNAR', 'roleArn' => '<string>', 'source' => '<string>', 'status' => 'INITIALIZING|EXPORTING|ANALYZING_DATA|IMPORTING|REPROVISIONING|ROLLING_BACK|SUCCEEDED|FAILED|CANCELLING|CANCELLED|DELETED', 'taskId' => '<string>', ], // ... ], ]
Result Details
Members
- nextToken
-
- Type: string
Pagination token used to paginate output.
When this value is provided as input, the service returns results from where the previous response left off. When this value is present in output, it indicates that there are more results to retrieve.
- tasks
-
- Required: Yes
- Type: Array of ImportTaskSummary structures
The requested list of import tasks.
Errors
- ThrottlingException:
The exception was interrupted by throttling.
- ValidationException:
A resource could not be validated.
- InternalServerException:
A failure occurred on the server.
- ResourceNotFoundException:
A specified resource could not be located.
ListPrivateGraphEndpoints
$result = $client->listPrivateGraphEndpoints
([/* ... */]); $promise = $client->listPrivateGraphEndpointsAsync
([/* ... */]);
Lists private endpoints for a specified Neptune Analytics graph.
Parameter Syntax
$result = $client->listPrivateGraphEndpoints([ 'graphIdentifier' => '<string>', // REQUIRED 'maxResults' => <integer>, 'nextToken' => '<string>', ]);
Parameter Details
Members
- graphIdentifier
-
- Required: Yes
- Type: string
The unique identifier of the Neptune Analytics graph.
- maxResults
-
- Type: int
The total number of records to return in the command's output.
If the total number of records available is more than the value specified,
nextToken
is provided in the command's output. To resume pagination, provide thenextToken
output value in thenextToken
argument of a subsequent command. Do not use thenextToken
response element directly outside of the Amazon CLI. - nextToken
-
- Type: string
Pagination token used to paginate output.
When this value is provided as input, the service returns results from where the previous response left off. When this value is present in output, it indicates that there are more results to retrieve.
Result Syntax
[ 'nextToken' => '<string>', 'privateGraphEndpoints' => [ [ 'status' => 'CREATING|AVAILABLE|DELETING|FAILED', 'subnetIds' => ['<string>', ...], 'vpcEndpointId' => '<string>', 'vpcId' => '<string>', ], // ... ], ]
Result Details
Members
- nextToken
-
- Type: string
Pagination token used to paginate output.
When this value is provided as input, the service returns results from where the previous response left off. When this value is present in output, it indicates that there are more results to retrieve.
- privateGraphEndpoints
-
- Required: Yes
- Type: Array of PrivateGraphEndpointSummary structures
A list of private endpoints for the specified Neptune Analytics graph.
Errors
- ThrottlingException:
The exception was interrupted by throttling.
- ValidationException:
A resource could not be validated.
- InternalServerException:
A failure occurred on the server.
- ResourceNotFoundException:
A specified resource could not be located.
ListQueries
$result = $client->listQueries
([/* ... */]); $promise = $client->listQueriesAsync
([/* ... */]);
Lists active openCypher queries.
Parameter Syntax
$result = $client->listQueries([ 'graphIdentifier' => '<string>', // REQUIRED 'maxResults' => <integer>, // REQUIRED 'state' => 'ALL|RUNNING|WAITING|CANCELLING', ]);
Parameter Details
Members
- graphIdentifier
-
- Required: Yes
- Type: string
The unique identifier of the Neptune Analytics graph.
- maxResults
-
- Required: Yes
- Type: int
The maximum number of results to be fetched by the API.
- state
-
- Type: string
Filtered list of queries based on state.
Result Syntax
[ 'queries' => [ [ 'elapsed' => <integer>, 'id' => '<string>', 'queryString' => '<string>', 'state' => 'RUNNING|WAITING|CANCELLING', 'waited' => <integer>, ], // ... ], ]
Result Details
Members
- queries
-
- Required: Yes
- Type: Array of QuerySummary structures
A list of current openCypher queries.
Errors
- ThrottlingException:
The exception was interrupted by throttling.
- ValidationException:
A resource could not be validated.
- AccessDeniedException:
Raised in case of an authentication or authorization failure.
- InternalServerException:
A failure occurred on the server.
ListTagsForResource
$result = $client->listTagsForResource
([/* ... */]); $promise = $client->listTagsForResourceAsync
([/* ... */]);
Lists tags associated with a specified resource.
Parameter Syntax
$result = $client->listTagsForResource([ 'resourceArn' => '<string>', // REQUIRED ]);
Parameter Details
Members
- resourceArn
-
- Required: Yes
- Type: string
The ARN of the resource.
Result Syntax
[ 'tags' => ['<string>', ...], ]
Result Details
Members
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
The list of metadata tags associated with the resource.
Errors
- ThrottlingException:
The exception was interrupted by throttling.
- ValidationException:
A resource could not be validated.
- InternalServerException:
A failure occurred on the server.
- ResourceNotFoundException:
A specified resource could not be located.
ResetGraph
$result = $client->resetGraph
([/* ... */]); $promise = $client->resetGraphAsync
([/* ... */]);
Empties the data from a specified Neptune Analytics graph.
Parameter Syntax
$result = $client->resetGraph([ 'graphIdentifier' => '<string>', // REQUIRED 'skipSnapshot' => true || false, // REQUIRED ]);
Parameter Details
Members
- graphIdentifier
-
- Required: Yes
- Type: string
ID of the graph to reset.
- skipSnapshot
-
- Required: Yes
- Type: boolean
Determines whether a final graph snapshot is created before the graph data is deleted. If set to
true
, no graph snapshot is created. If set tofalse
, a graph snapshot is created before the data is deleted.
Result Syntax
[ 'arn' => '<string>', 'buildNumber' => '<string>', 'createTime' => <DateTime>, 'deletionProtection' => true || false, 'endpoint' => '<string>', 'id' => '<string>', 'kmsKeyIdentifier' => '<string>', 'name' => '<string>', 'provisionedMemory' => <integer>, 'publicConnectivity' => true || false, 'replicaCount' => <integer>, 'sourceSnapshotId' => '<string>', 'status' => 'CREATING|AVAILABLE|DELETING|RESETTING|UPDATING|SNAPSHOTTING|FAILED|IMPORTING', 'statusReason' => '<string>', 'vectorSearchConfiguration' => [ 'dimension' => <integer>, ], ]
Result Details
Members
- arn
-
- Required: Yes
- Type: string
The ARN associated with the graph.
- buildNumber
-
- Type: string
The build number of the graph.
- createTime
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time at which the graph was created.
- deletionProtection
-
- Type: boolean
If
true
, deletion protection is enabled for the graph. - endpoint
-
- Type: string
The graph endpoint.
- id
-
- Required: Yes
- Type: string
The unique identifier of the graph.
- kmsKeyIdentifier
-
- Type: string
The ID of the KMS key used to encrypt and decrypt graph data.
- name
-
- Required: Yes
- Type: string
The name of the graph.
- provisionedMemory
-
- Type: int
The number of memory-optimized Neptune Capacity Units (m-NCUs) allocated to the graph.
- publicConnectivity
-
- Type: boolean
If
true
, the graph has a public endpoint, otherwise not. - replicaCount
-
- Type: int
The number of replicas for the graph.
- sourceSnapshotId
-
- Type: string
The ID of the snapshot from which the graph was created, if any.
- status
-
- Type: string
The status of the graph.
- statusReason
-
- Type: string
The reason that the graph has this status.
- vectorSearchConfiguration
-
- Type: VectorSearchConfiguration structure
Specifies the number of dimensions for vector embeddings loaded into the graph. Max = 65535
Errors
- ThrottlingException:
The exception was interrupted by throttling.
- ValidationException:
A resource could not be validated.
- ConflictException:
Raised when a conflict is encountered.
- InternalServerException:
A failure occurred on the server.
- ResourceNotFoundException:
A specified resource could not be located.
RestoreGraphFromSnapshot
$result = $client->restoreGraphFromSnapshot
([/* ... */]); $promise = $client->restoreGraphFromSnapshotAsync
([/* ... */]);
Restores a graph from a snapshot.
Parameter Syntax
$result = $client->restoreGraphFromSnapshot([ 'deletionProtection' => true || false, 'graphName' => '<string>', // REQUIRED 'provisionedMemory' => <integer>, 'publicConnectivity' => true || false, 'replicaCount' => <integer>, 'snapshotIdentifier' => '<string>', // REQUIRED 'tags' => ['<string>', ...], ]);
Parameter Details
Members
- deletionProtection
-
- Type: boolean
A value that indicates whether the graph has deletion protection enabled. The graph can't be deleted when deletion protection is enabled.
- graphName
-
- Required: Yes
- Type: string
A name for the new Neptune Analytics graph to be created from the snapshot.
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.
- provisionedMemory
-
- Type: int
The provisioned memory-optimized Neptune Capacity Units (m-NCUs) to use for the graph.
Min = 128
- publicConnectivity
-
- Type: boolean
Specifies whether or not the graph can be reachable over the internet. All access to graphs is IAM authenticated. (
true
to enable, orfalse
to disable). - replicaCount
-
- Type: int
The number of replicas in other AZs. Min =0, Max = 2, Default =1
Additional charges equivalent to the m-NCUs selected for the graph apply for each replica.
- snapshotIdentifier
-
- Required: Yes
- Type: string
The ID of the snapshot in question.
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
Adds metadata tags to the snapshot. These tags can also be used with cost allocation reporting, or used in a Condition statement in an IAM policy.
Result Syntax
[ 'arn' => '<string>', 'buildNumber' => '<string>', 'createTime' => <DateTime>, 'deletionProtection' => true || false, 'endpoint' => '<string>', 'id' => '<string>', 'kmsKeyIdentifier' => '<string>', 'name' => '<string>', 'provisionedMemory' => <integer>, 'publicConnectivity' => true || false, 'replicaCount' => <integer>, 'sourceSnapshotId' => '<string>', 'status' => 'CREATING|AVAILABLE|DELETING|RESETTING|UPDATING|SNAPSHOTTING|FAILED|IMPORTING', 'statusReason' => '<string>', 'vectorSearchConfiguration' => [ 'dimension' => <integer>, ], ]
Result Details
Members
- arn
-
- Required: Yes
- Type: string
The ARN associated with the graph.
- buildNumber
-
- Type: string
The build number of the graph.
- createTime
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time at which the graph was created.
- deletionProtection
-
- Type: boolean
If
true
, deletion protection is enabled for the graph. - endpoint
-
- Type: string
The graph endpoint.
- id
-
- Required: Yes
- Type: string
The unique identifier of the graph.
- kmsKeyIdentifier
-
- Type: string
The ID of the KMS key used to encrypt and decrypt graph data.
- name
-
- Required: Yes
- Type: string
The name of the graph.
- provisionedMemory
-
- Type: int
The number of memory-optimized Neptune Capacity Units (m-NCUs) allocated to the graph.
- publicConnectivity
-
- Type: boolean
If
true
, the graph has a public endpoint, otherwise not. - replicaCount
-
- Type: int
The number of replicas for the graph.
- sourceSnapshotId
-
- Type: string
The ID of the snapshot from which the graph was created, if any.
- status
-
- Type: string
The status of the graph.
- statusReason
-
- Type: string
The reason that the graph has this status.
- vectorSearchConfiguration
-
- Type: VectorSearchConfiguration structure
Specifies the number of dimensions for vector embeddings loaded into the graph. Max = 65535
Errors
- ServiceQuotaExceededException:
A service quota was exceeded.
- ThrottlingException:
The exception was interrupted by throttling.
- ValidationException:
A resource could not be validated.
- ConflictException:
Raised when a conflict is encountered.
- InternalServerException:
A failure occurred on the server.
- ResourceNotFoundException:
A specified resource could not be located.
StartExportTask
$result = $client->startExportTask
([/* ... */]); $promise = $client->startExportTaskAsync
([/* ... */]);
Export data from an existing Neptune Analytics graph to Amazon S3. The graph state should be AVAILABLE
.
Parameter Syntax
$result = $client->startExportTask([ 'destination' => '<string>', // REQUIRED 'exportFilter' => [ 'edgeFilter' => [ '<ExportFilterLabel>' => [ 'properties' => [ '<ExportFilterOutputPropertyName>' => [ 'multiValueHandling' => 'TO_LIST|PICK_FIRST', 'outputType' => '<string>', 'sourcePropertyName' => '<string>', ], // ... ], ], // ... ], 'vertexFilter' => [ '<ExportFilterLabel>' => [ 'properties' => [ '<ExportFilterOutputPropertyName>' => [ 'multiValueHandling' => 'TO_LIST|PICK_FIRST', 'outputType' => '<string>', 'sourcePropertyName' => '<string>', ], // ... ], ], // ... ], ], 'format' => 'PARQUET|CSV', // REQUIRED 'graphIdentifier' => '<string>', // REQUIRED 'kmsKeyIdentifier' => '<string>', // REQUIRED 'parquetType' => 'COLUMNAR', 'roleArn' => '<string>', // REQUIRED 'tags' => ['<string>', ...], ]);
Parameter Details
Members
- destination
-
- Required: Yes
- Type: string
The Amazon S3 URI where data will be exported to.
- exportFilter
-
- Type: ExportFilter structure
The export filter of the export task.
- format
-
- Required: Yes
- Type: string
The format of the export task.
- graphIdentifier
-
- Required: Yes
- Type: string
The source graph identifier of the export task.
- kmsKeyIdentifier
-
- Required: Yes
- Type: string
The KMS key identifier of the export task.
- parquetType
-
- Type: string
The parquet type of the export task.
- roleArn
-
- Required: Yes
- Type: string
The ARN of the IAM role that will allow data to be exported to the destination.
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
Tags to be applied to the export task.
Result Syntax
[ 'destination' => '<string>', 'exportFilter' => [ 'edgeFilter' => [ '<ExportFilterLabel>' => [ 'properties' => [ '<ExportFilterOutputPropertyName>' => [ 'multiValueHandling' => 'TO_LIST|PICK_FIRST', 'outputType' => '<string>', 'sourcePropertyName' => '<string>', ], // ... ], ], // ... ], 'vertexFilter' => [ '<ExportFilterLabel>' => [ 'properties' => [ '<ExportFilterOutputPropertyName>' => [ 'multiValueHandling' => 'TO_LIST|PICK_FIRST', 'outputType' => '<string>', 'sourcePropertyName' => '<string>', ], // ... ], ], // ... ], ], 'format' => 'PARQUET|CSV', 'graphId' => '<string>', 'kmsKeyIdentifier' => '<string>', 'parquetType' => 'COLUMNAR', 'roleArn' => '<string>', 'status' => 'INITIALIZING|EXPORTING|SUCCEEDED|FAILED|CANCELLING|CANCELLED|DELETED', 'statusReason' => '<string>', 'taskId' => '<string>', ]
Result Details
Members
- destination
-
- Required: Yes
- Type: string
The Amazon S3 URI of the export task where data will be exported to.
- exportFilter
-
- Type: ExportFilter structure
The export filter of the export task.
- format
-
- Required: Yes
- Type: string
The format of the export task.
- graphId
-
- Required: Yes
- Type: string
The source graph identifier of the export task.
- kmsKeyIdentifier
-
- Required: Yes
- Type: string
The KMS key identifier of the export task.
- parquetType
-
- Type: string
The parquet type of the export task.
- roleArn
-
- Required: Yes
- Type: string
The ARN of the IAM role that will allow data to be exported to the destination.
- status
-
- Required: Yes
- Type: string
The current status of the export task.
- statusReason
-
- Type: string
The reason that the export task has this status value.
- taskId
-
- Required: Yes
- Type: string
The unique identifier of the export task.
Errors
- ThrottlingException:
The exception was interrupted by throttling.
- ValidationException:
A resource could not be validated.
- ConflictException:
Raised when a conflict is encountered.
- InternalServerException:
A failure occurred on the server.
- ResourceNotFoundException:
A specified resource could not be located.
StartImportTask
$result = $client->startImportTask
([/* ... */]); $promise = $client->startImportTaskAsync
([/* ... */]);
Import data into existing Neptune Analytics graph from Amazon Simple Storage Service (S3). The graph needs to be empty and in the AVAILABLE state.
Parameter Syntax
$result = $client->startImportTask([ 'blankNodeHandling' => 'convertToIri', 'failOnError' => true || false, 'format' => 'CSV|OPEN_CYPHER|PARQUET|NTRIPLES', 'graphIdentifier' => '<string>', // REQUIRED 'importOptions' => [ 'neptune' => [ 'preserveDefaultVertexLabels' => true || false, 'preserveEdgeIds' => true || false, 's3ExportKmsKeyId' => '<string>', // REQUIRED 's3ExportPath' => '<string>', // REQUIRED ], ], 'parquetType' => 'COLUMNAR', 'roleArn' => '<string>', // REQUIRED 'source' => '<string>', // REQUIRED ]);
Parameter Details
Members
- blankNodeHandling
-
- Type: string
The method to handle blank nodes in the dataset. Currently, only
convertToIri
is supported, meaning blank nodes are converted to unique IRIs at load time. Must be provided when format isntriples
. For more information, see Handling RDF values. - failOnError
-
- Type: boolean
If set to true, the task halts when an import error is encountered. If set to false, the task skips the data that caused the error and continues if possible.
- format
-
- Type: string
Specifies the format of Amazon S3 data to be imported. Valid values are CSV, which identifies the Gremlin CSV format or OPENCYPHER, which identies the openCypher load format.
- graphIdentifier
-
- Required: Yes
- Type: string
The unique identifier of the Neptune Analytics graph.
- importOptions
-
- Type: ImportOptions structure
Options for how to perform an import.
- parquetType
-
- Type: string
The parquet type of the import task.
- roleArn
-
- Required: Yes
- Type: string
The ARN of the IAM role that will allow access to the data that is to be imported.
- source
-
- Required: Yes
- Type: string
A URL identifying the location of the data to be imported. This can be an Amazon S3 path, or can point to a Neptune database endpoint or snapshot.
Result Syntax
[ 'format' => 'CSV|OPEN_CYPHER|PARQUET|NTRIPLES', 'graphId' => '<string>', 'importOptions' => [ 'neptune' => [ 'preserveDefaultVertexLabels' => true || false, 'preserveEdgeIds' => true || false, 's3ExportKmsKeyId' => '<string>', 's3ExportPath' => '<string>', ], ], 'parquetType' => 'COLUMNAR', 'roleArn' => '<string>', 'source' => '<string>', 'status' => 'INITIALIZING|EXPORTING|ANALYZING_DATA|IMPORTING|REPROVISIONING|ROLLING_BACK|SUCCEEDED|FAILED|CANCELLING|CANCELLED|DELETED', 'taskId' => '<string>', ]
Result Details
Members
- format
-
- Type: string
Specifies the format of Amazon S3 data to be imported. Valid values are CSV, which identifies the Gremlin CSV format or OPENCYPHER, which identies the openCypher load format.
- graphId
-
- Type: string
The unique identifier of the Neptune Analytics graph.
- importOptions
-
- Type: ImportOptions structure
Options for how to perform an import.
- parquetType
-
- Type: string
The parquet type of the import task.
- roleArn
-
- Required: Yes
- Type: string
The ARN of the IAM role that will allow access to the data that is to be imported.
- source
-
- Required: Yes
- Type: string
A URL identifying the location of the data to be imported. This can be an Amazon S3 path, or can point to a Neptune database endpoint or snapshot.
- status
-
- Required: Yes
- Type: string
The status of the import task.
- taskId
-
- Required: Yes
- Type: string
The unique identifier of the import task.
Errors
- ThrottlingException:
The exception was interrupted by throttling.
- ValidationException:
A resource could not be validated.
- ConflictException:
Raised when a conflict is encountered.
- InternalServerException:
A failure occurred on the server.
- ResourceNotFoundException:
A specified resource could not be located.
TagResource
$result = $client->tagResource
([/* ... */]); $promise = $client->tagResourceAsync
([/* ... */]);
Adds tags to the specified resource.
Parameter Syntax
$result = $client->tagResource([ 'resourceArn' => '<string>', // REQUIRED 'tags' => ['<string>', ...], // REQUIRED ]);
Parameter Details
Members
- resourceArn
-
- Required: Yes
- Type: string
ARN of the resource for which tags need to be added.
- tags
-
- Required: Yes
- Type: Associative array of custom strings keys (TagKey) to strings
The tags to be assigned to the Neptune Analytics resource.
The tags are metadata that are specified as a list of key-value pairs:
Key (string)  –  A key is the required name of the tag. The string value can be from 1 to 128 Unicode characters in length. It can't be prefixed with
aws:
and can only contain the set of Unicode characters specified by this Java regular expression:"^([\p{L}\p{Z}\p{N}_.:/=+\-]*)$")
.Value (string)  –  A value is the optional value of the tag. The string value can be from 1 to 256 Unicode characters in length. It can't be prefixed with
aws:
and can only contain the set of Unicode characters specified by this Java regular expression:"^([\p{L}\p{Z}\p{N}_.:/=+\-]*)$")
.
Result Syntax
[]
Result Details
Errors
- ThrottlingException:
The exception was interrupted by throttling.
- ValidationException:
A resource could not be validated.
- InternalServerException:
A failure occurred on the server.
- ResourceNotFoundException:
A specified resource could not be located.
UntagResource
$result = $client->untagResource
([/* ... */]); $promise = $client->untagResourceAsync
([/* ... */]);
Removes the specified tags from the specified resource.
Parameter Syntax
$result = $client->untagResource([ 'resourceArn' => '<string>', // REQUIRED 'tagKeys' => ['<string>', ...], // REQUIRED ]);
Parameter Details
Members
- resourceArn
-
- Required: Yes
- Type: string
ARN of the resource whose tag needs to be removed.
- tagKeys
-
- Required: Yes
- Type: Array of strings
Tag keys for the tags to be removed.
Result Syntax
[]
Result Details
Errors
- ThrottlingException:
The exception was interrupted by throttling.
- ValidationException:
A resource could not be validated.
- InternalServerException:
A failure occurred on the server.
- ResourceNotFoundException:
A specified resource could not be located.
UpdateGraph
$result = $client->updateGraph
([/* ... */]); $promise = $client->updateGraphAsync
([/* ... */]);
Updates the configuration of a specified Neptune Analytics graph
Parameter Syntax
$result = $client->updateGraph([ 'deletionProtection' => true || false, 'graphIdentifier' => '<string>', // REQUIRED 'provisionedMemory' => <integer>, 'publicConnectivity' => true || false, ]);
Parameter Details
Members
- deletionProtection
-
- Type: boolean
A value that indicates whether the graph has deletion protection enabled. The graph can't be deleted when deletion protection is enabled.
- graphIdentifier
-
- Required: Yes
- Type: string
The unique identifier of the Neptune Analytics graph.
- provisionedMemory
-
- Type: int
The provisioned memory-optimized Neptune Capacity Units (m-NCUs) to use for the graph.
Min = 128
- publicConnectivity
-
- Type: boolean
Specifies whether or not the graph can be reachable over the internet. All access to graphs is IAM authenticated. (
true
to enable, orfalse
to disable.
Result Syntax
[ 'arn' => '<string>', 'buildNumber' => '<string>', 'createTime' => <DateTime>, 'deletionProtection' => true || false, 'endpoint' => '<string>', 'id' => '<string>', 'kmsKeyIdentifier' => '<string>', 'name' => '<string>', 'provisionedMemory' => <integer>, 'publicConnectivity' => true || false, 'replicaCount' => <integer>, 'sourceSnapshotId' => '<string>', 'status' => 'CREATING|AVAILABLE|DELETING|RESETTING|UPDATING|SNAPSHOTTING|FAILED|IMPORTING', 'statusReason' => '<string>', 'vectorSearchConfiguration' => [ 'dimension' => <integer>, ], ]
Result Details
Members
- arn
-
- Required: Yes
- Type: string
The ARN associated with the graph.
- buildNumber
-
- Type: string
The build number of the graph.
- createTime
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time at which the graph was created.
- deletionProtection
-
- Type: boolean
If
true
, deletion protection is enabled for the graph. - endpoint
-
- Type: string
The graph endpoint.
- id
-
- Required: Yes
- Type: string
The unique identifier of the graph.
- kmsKeyIdentifier
-
- Type: string
The ID of the KMS key used to encrypt and decrypt graph data.
- name
-
- Required: Yes
- Type: string
The name of the graph.
- provisionedMemory
-
- Type: int
The number of memory-optimized Neptune Capacity Units (m-NCUs) allocated to the graph.
- publicConnectivity
-
- Type: boolean
If
true
, the graph has a public endpoint, otherwise not. - replicaCount
-
- Type: int
The number of replicas for the graph.
- sourceSnapshotId
-
- Type: string
The ID of the snapshot from which the graph was created, if any.
- status
-
- Type: string
The status of the graph.
- statusReason
-
- Type: string
The reason that the graph has this status.
- vectorSearchConfiguration
-
- Type: VectorSearchConfiguration structure
Specifies the number of dimensions for vector embeddings loaded into the graph. Max = 65535
Errors
- ThrottlingException:
The exception was interrupted by throttling.
- ValidationException:
A resource could not be validated.
- ConflictException:
Raised when a conflict is encountered.
- InternalServerException:
A failure occurred on the server.
- ResourceNotFoundException:
A specified resource could not be located.
Shapes
AccessDeniedException
Description
Raised in case of an authentication or authorization failure.
Members
- message
-
- Required: Yes
- Type: string
A message describing the problem.
ConflictException
Description
Raised when a conflict is encountered.
Members
- message
-
- Required: Yes
- Type: string
A message describing the problem.
- reason
-
- Type: string
The reason for the conflict exception.
Document
Members
EdgeStructure
Description
Contains information about an edge in a Neptune Analytics graph.
Members
- count
-
- Type: long (int|float)
The number of instances of the edge in the graph.
- edgeProperties
-
- Type: Array of strings
A list of the properties associated with the edge.
ExportFilter
Description
This is the top-level field for specifying vertex or edge filters. If the ExportFilter is not provided, then all properties for all labels will be exported. If the ExportFilter is provided but is an empty object, then no data will be exported.
Members
- edgeFilter
-
- Type: Associative array of custom strings keys (ExportFilterLabel) to ExportFilterElement structures
Used to specify filters on a per-label basis for edges. This allows you to control which edge labels and properties are included in the export.
- vertexFilter
-
- Type: Associative array of custom strings keys (ExportFilterLabel) to ExportFilterElement structures
Used to specify filters on a per-label basis for vertices. This allows you to control which vertex labels and properties are included in the export.
ExportFilterElement
Description
Specifies whihc properties of that label should be included in the export.
Members
- properties
-
- Type: Associative array of custom strings keys (ExportFilterOutputPropertyName) to ExportFilterPropertyAttributes structures
Each property is defined by a key-value pair, where the key is the desired output property name (e.g. "name"), and the value is an object.
ExportFilterPropertyAttributes
Description
A structure representing a property's attributes. It is a map object of outputType, sourcePropertyName and multiValueHandling.
Members
- multiValueHandling
-
- Type: string
Specifies how to handle properties that have multiple values. Can be either
TO_LIST
to export all values as a list, orPICK_FIRST
to export the first value encountered. If not specified, the default value isPICK_FIRST
. - outputType
-
- Type: string
Specifies the data type to use for the property in the exported data (e.g. "String", "Int", "Float"). If a type is not provided, the export process will determine the type. If a given property is present as multiple types (e.g. one vertex has "height" stored as a double, and another edge has it stored as a string), the type will be of Any type, otherwise, it will be the type of the property as present in vertices.
- sourcePropertyName
-
- Type: string
The name of the property as it exists in the original graph data. If not provided, it is assumed that the key matches the desired sourcePropertyName.
ExportTaskDetails
Description
Contains details about the specified export task.
Members
- numEdgesWritten
-
- Type: long (int|float)
The number of exported edges.
- numVerticesWritten
-
- Type: long (int|float)
The number of exported vertices.
- progressPercentage
-
- Required: Yes
- Type: int
The number of progress percentage of the export task.
- startTime
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The start time of the export task.
- timeElapsedSeconds
-
- Required: Yes
- Type: long (int|float)
The time elapsed, in seconds, since the start time of the export task.
ExportTaskSummary
Description
Provides details about an export task.
Members
- destination
-
- Required: Yes
- Type: string
The Amazon S3 URI of the export task where data will be exported to.
- format
-
- Required: Yes
- Type: string
The format of the export task.
- graphId
-
- Required: Yes
- Type: string
The source graph identifier of the export task.
- kmsKeyIdentifier
-
- Required: Yes
- Type: string
The KMS key identifier of the export task.
- parquetType
-
- Type: string
The parquet type of the export task.
- roleArn
-
- Required: Yes
- Type: string
The ARN of the IAM role that will allow the data to be exported to the destination.
- status
-
- Required: Yes
- Type: string
The current status of the export task.
- statusReason
-
- Type: string
The reason that the export task has this status value.
- taskId
-
- Required: Yes
- Type: string
The unique identifier of the export task.
GraphDataSummary
Description
Summary information about the graph.
Members
- edgeLabels
-
- Type: Array of strings
A list of the edge labels in the graph.
- edgeProperties
-
- Type: Array of maps
A list of the distinct edge properties in the graph, along with the count of edges where each property is used.
- edgeStructures
-
- Type: Array of EdgeStructure structures
This field is only present when the requested mode is DETAILED. It contains a list of edge structures.
- nodeLabels
-
- Type: Array of strings
A list of distinct node labels in the graph.
- nodeProperties
-
- Type: Array of maps
A list of the distinct node properties in the graph, along with the count of nodes where each property is used.
- nodeStructures
-
- Type: Array of NodeStructure structures
This field is only present when the requested mode is DETAILED. It contains a list of node structures.
- numEdgeLabels
-
- Type: long (int|float)
The number of unique edge labels in the graph.
- numEdgeProperties
-
- Type: long (int|float)
The number of edge properties in the graph.
- numEdges
-
- Type: long (int|float)
The number of edges in the graph.
- numNodeLabels
-
- Type: long (int|float)
The number of distinct node labels in the graph.
- numNodeProperties
-
- Type: long (int|float)
The number of distinct node properties in the graph.
- numNodes
-
- Type: long (int|float)
The number of nodes in the graph.
- totalEdgePropertyValues
-
- Type: long (int|float)
The total number of usages of all edge properties.
- totalNodePropertyValues
-
- Type: long (int|float)
The total number of usages of all node properties.
GraphSnapshotSummary
Description
Details about a graph snapshot.
Members
- arn
-
- Required: Yes
- Type: string
The ARN of the graph snapshot.
- id
-
- Required: Yes
- Type: string
The unique identifier of the graph snapshot.
- kmsKeyIdentifier
-
- Type: string
The ID of the KMS key used to encrypt and decrypt the snapshot.
- name
-
- Required: Yes
- Type: string
The snapshot name. For example:
my-snapshot-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.
- snapshotCreateTime
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time when the snapshot was created.
- sourceGraphId
-
- Type: string
The graph identifier for the graph for which a snapshot is to be created.
- status
-
- Type: string
The status of the graph snapshot.
GraphSummary
Description
Summary details about a graph.
Members
- arn
-
- Required: Yes
- Type: string
The ARN associated with the graph.
- deletionProtection
-
- Type: boolean
If
true
, deletion protection is enabled for the graph. - endpoint
-
- Type: string
The graph endpoint.
- id
-
- Required: Yes
- Type: string
The unique identifier of the graph.
- kmsKeyIdentifier
-
- Type: string
The ID of the KMS key used to encrypt and decrypt graph data.
- name
-
- Required: Yes
- Type: string
The name of the graph.
- provisionedMemory
-
- Type: int
The number of memory-optimized Neptune Capacity Units (m-NCUs) allocated to the graph.
- publicConnectivity
-
- Type: boolean
If
true
, the graph has a public endpoint, otherwise not. - replicaCount
-
- Type: int
The number of replicas for the graph.
- status
-
- Type: string
The status of the graph.
ImportOptions
Description
Options for how to perform an import.
Members
- neptune
-
- Type: NeptuneImportOptions structure
Options for importing data from a Neptune database.
ImportTaskDetails
Description
Contains details about an import task.
Members
- dictionaryEntryCount
-
- Required: Yes
- Type: long (int|float)
The number of dictionary entries in the import task.
- errorCount
-
- Required: Yes
- Type: int
The number of errors encountered so far.
- errorDetails
-
- Type: string
Details about the errors that have been encountered.
- progressPercentage
-
- Required: Yes
- Type: int
The percentage progress so far.
- startTime
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
Time at which the import task started.
- statementCount
-
- Required: Yes
- Type: long (int|float)
The number of statements in the import task.
- status
-
- Required: Yes
- Type: string
Status of the import task.
- timeElapsedSeconds
-
- Required: Yes
- Type: long (int|float)
Seconds elapsed since the import task started.
ImportTaskSummary
Description
Details about an import task.
Members
- format
-
- Type: string
Specifies the format of S3 data to be imported. Valid values are
CSV
, which identifies the Gremlin CSV format orOPENCYPHER
, which identies the openCypher load format. - graphId
-
- Type: string
The unique identifier of the Neptune Analytics graph.
- parquetType
-
- Type: string
The parquet type of the import task.
- roleArn
-
- Required: Yes
- Type: string
The ARN of the IAM role that will allow access to the data that is to be imported.
- source
-
- Required: Yes
- Type: string
A URL identifying to the location of the data to be imported. This can be an Amazon S3 path, or can point to a Neptune database endpoint or snapshot
- status
-
- Required: Yes
- Type: string
Status of the import task.
- taskId
-
- Required: Yes
- Type: string
The unique identifier of the import task.
InternalServerException
Description
A failure occurred on the server.
Members
- message
-
- Required: Yes
- Type: string
A message describing the problem.
NeptuneImportOptions
Description
Options for how to import Neptune data.
Members
- preserveDefaultVertexLabels
-
- Type: boolean
Neptune Analytics supports label-less vertices and no labels are assigned unless one is explicitly provided. Neptune assigns default labels when none is explicitly provided. When importing the data into Neptune Analytics, the default vertex labels can be omitted by setting preserveDefaultVertexLabels to false. Note that if the vertex only has default labels, and has no other properties or edges, then the vertex will effectively not get imported into Neptune Analytics when preserveDefaultVertexLabels is set to false.
- preserveEdgeIds
-
- Type: boolean
Neptune Analytics currently does not support user defined edge ids. The edge ids are not imported by default. They are imported if preserveEdgeIds is set to true, and ids are stored as properties on the relationships with the property name neptuneEdgeId.
- s3ExportKmsKeyId
-
- Required: Yes
- Type: string
The KMS key to use to encrypt data in the S3 bucket where the graph data is exported
- s3ExportPath
-
- Required: Yes
- Type: string
The path to an S3 bucket from which to import data.
NodeStructure
Description
Information about a node.
Members
- count
-
- Type: long (int|float)
The number of instances of this node.
- distinctOutgoingEdgeLabels
-
- Type: Array of strings
The outgoing edge labels associated with this node.
- nodeProperties
-
- Type: Array of strings
Properties associated with this node.
PrivateGraphEndpointSummary
Description
Details about a private graph endpoint.
Members
- status
-
- Required: Yes
- Type: string
The status of the private graph endpoint.
- subnetIds
-
- Required: Yes
- Type: Array of strings
The subnet IDs associated with the private graph endpoint.
- vpcEndpointId
-
- Type: string
The ID of the VPC endpoint.
- vpcId
-
- Required: Yes
- Type: string
The ID of the VPC in which the private graph endpoint is located.
QuerySummary
Description
Details of the query listed.
Members
- elapsed
-
- Type: int
The running time of the query, in milliseconds.
- id
-
- Type: string
A string representation of the id of the query.
- queryString
-
- Type: string
The actual query text. The
queryString
may be truncated if the actual query string is too long. - state
-
- Type: string
State of the query.
- waited
-
- Type: int
The amount of time, in milliseconds, the query has waited in the queue before being picked up by a worker thread.
ResourceNotFoundException
Description
A specified resource could not be located.
Members
- message
-
- Required: Yes
- Type: string
A message describing the problem.
ServiceQuotaExceededException
Description
A service quota was exceeded.
Members
- message
-
- Required: Yes
- Type: string
- quotaCode
-
- Type: string
Service quota code of the resource for which quota was exceeded.
- resourceId
-
- Type: string
The identifier of the resource that exceeded quota.
- resourceType
-
- Type: string
The type of the resource that exceeded quota. Ex: Graph, Snapshot
- serviceCode
-
- Type: string
The service code that exceeded quota.
ThrottlingException
Description
The exception was interrupted by throttling.
Members
- message
-
- Required: Yes
- Type: string
A message describing the problem.
UnprocessableException
Description
Request cannot be processed due to known reasons. Eg. partition full.
Members
- message
-
- Required: Yes
- Type: string
- reason
-
- Required: Yes
- Type: string
The reason for the unprocessable exception.
ValidationException
Description
A resource could not be validated.
Members
- message
-
- Required: Yes
- Type: string
A message describing the problem.
- reason
-
- Type: string
The reason that the resource could not be validated.
VectorSearchConfiguration
Description
Specifies the number of dimensions for vector embeddings loaded into the graph. Max = 65535
Members
- dimension
-
- Required: Yes
- Type: int
The number of dimensions.