AWS neptune documentation change
Summary
Added examples for using AWS CLI, SDK, awscurl, and curl to start a Neptune bulk loader job with chained IAM roles.
Security assessment
This change adds multi-tool examples for starting a loader job with chained IAM roles, which is a routine documentation enhancement. While IAM roles are a security feature, this change does not introduce new security documentation; it merely provides alternative ways to use an existing feature. No security vulnerabilities or incidents are referenced.
Diff
diff --git a/neptune/latest/userguide/bulk-load-tutorial-chain-roles.md b/neptune/latest/userguide/bulk-load-tutorial-chain-roles.md index ab5f234d8..9fb66c622 100644 --- a//neptune/latest/userguide/bulk-load-tutorial-chain-roles.md +++ b//neptune/latest/userguide/bulk-load-tutorial-chain-roles.md @@ -173,0 +174 @@ Although you'll mostly only need to have two roles in a chain, it is certainly p +AWS CLI @@ -175 +176,58 @@ Although you'll mostly only need to have two roles in a chain, it is certainly p - curl -X POST https://localhost:8182/loader \ + + + aws neptunedata start-loader-job \ + --endpoint-url https://your-neptune-endpoint:port \ + --source "s3://(the target bucket name)/(the target date file name)" \ + --format "csv" \ + --iam-role-arn "arn:aws:iam::(Account A ID):role/(RoleA),arn:aws:iam::(Account B ID):role/(RoleB),arn:aws:iam::(Account C ID):role/(RoleC)" \ + --s3-bucket-region "us-east-1" + +For more information, see [start-loader-job](https://docs.aws.amazon.com/cli/latest/reference/neptunedata/start-loader-job.html) in the AWS CLI Command Reference. + +SDK + + + + import boto3 + from botocore.config import Config + + client = boto3.client( + 'neptunedata', + endpoint_url='https://your-neptune-endpoint:port', + config=Config(read_timeout=None, retries={'total_max_attempts': 1}) + ) + + response = client.start_loader_job( + source='s3://(the target bucket name)/(the target date file name)', + format='csv', + iamRoleArn='arn:aws:iam::(Account A ID):role/(RoleA),arn:aws:iam::(Account B ID):role/(RoleB),arn:aws:iam::(Account C ID):role/(RoleC)', + s3BucketRegion='us-east-1' + ) + + print(response) + +awscurl + + + + awscurl https://your-neptune-endpoint:port/loader \ + --region us-east-1 \ + --service neptune-db \ + -X POST \ + -H 'Content-Type: application/json' \ + -d '{ + "source" : "s3://(the target bucket name)/(the target date file name)", + "iamRoleArn" : "arn:aws:iam::(Account A ID):role/(RoleA),arn:aws:iam::(Account B ID):role/(RoleB),arn:aws:iam::(Account C ID):role/(RoleC)", + "format" : "csv", + "region" : "us-east-1" + }' + +###### Note + +This example assumes that your AWS credentials are configured in your environment. Replace `us-east-1` with the Region of your Neptune cluster. + +curl + + + + curl -X POST https://your-neptune-endpoint:port/loader \