Usa Autonomous AI Database API per DynamoDB

Di seguito è riportato un elenco di autorizzazioni per le chiavi di accesso.

Crea una chiave di accesso

Per creare una chiave di accesso e una chiave segreta nel database, è necessario aver eseguito il login come utente ADMIN o aver ottenuto il ruolo PDB_DBA.

Sintassi e richiesta di esempio per la creazione di una chiave di accesso nel database:

Utilizzare la richiesta API dell'endpoint REST POST https://dataaccess.adb.{oci-region-name}.oraclecloudapps.com/adb/auth/v1/databases/{database-ocid}/accesskeys per generare la chiave di accesso e la chiave segreta:

Sintassi

POST "https://dataaccess.adb.{oci-region-name}.oraclecloudapps.com/adb/auth/v1/databases/{database-ocid}/accesskeys"
{
  "name"          : "{<access_key_name>}",         // Required. The name you assign to the access key.
  "description"   : "{<access_key_description>}",  // Optional. A description for the access key.
  "permissions"   : [                             // Optional. Array of permission objects.
    {
      "actions"   : [<List of permissions>],      // Required. List of permitted actions (e.g., "read", "write").
      "resources" : [<List of Tables>]            // Optional. Only applicable for permissions that get applied on Table.
    }
    // ... additional permission objects as needed
  ],
  "expiration_minutes": 120                       // Optional. The key's expiration time in minutes.
}

Formato risposta di esempio

{  
  "name": "<access_key_name>",  
  "description": "<access_key_description>",  
  "access_key_id": "<access_key_id>",  
  "secret_access_key": "<generated secret>",  
  "expiration_timestamp": "<access_key_expiration_timestamp>",  
  "permissions": [  
    {  
      "actions"  : [<permissions list>],  
      "resources": [<optional DynamoDb table list>]  
    }  
    // ...more permission objects  
  ]  
}

Esempio: questo esempio mostra come inviare una richiesta POST all'API REST di Oracle Autonomous AI Database per creare una nuova chiave di accesso con autorizzazioni amministrative. La richiesta specifica il nome della chiave e le autorizzazioni necessarie e la risposta include l'ID chiave di accesso, il segreto, l'ora di scadenza e le autorizzazioni appena generate.

# Request
curl -X POST 'https://dataaccess.adb.us-phoenix-1.oraclecloudapps.com/adb/auth/v1/databases/OCID1.AUTONOMOUSDATABASE.OC1.PHX.ANYHQLJRGDV...EXAMPLE/accesskeys'\
--user "AdminUser:TestPass#" \
--header 'Request-Id: 8g89mz8qnet9ufxg4dwrus8m' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "adminkey",
    "permissions": [
        {
            "actions": [
                "ADMIN_ANY"
            ]
        }
    ],
    "expiration_minutes": 120
}'

# Sample Response
{
    "access_key_id": "ak_og67ZI8bdS.....BiHCda7l",
    "secret_access_key": "NzYwZDE5M2E4NDVjZ.....FmMzBiNQ>>",
    "expiration_time": "2025-12-07T03:35:12Z",
    "permissions": [
        {
            "actions": [
                "ADMIN_ANY"
            ]
        }
    ]
}

Recupera informazioni chiave di accesso

Dopo aver creato una chiave di accesso, utilizzare la richiesta API REST GET /accesskeys per cercare i relativi dettagli, ad esempio il nome, le autorizzazioni associate, l'ora di scadenza e altri metadati pertinenti. Ciò consente di confermare a livello di programmazione i diritti di accesso, di controllare le credenziali o di mostrare le informazioni sulle chiavi di accesso.

Sintassi ed esempio per recuperare i dettagli della chiave di accesso:

Sintassi:

GET https://dataaccess.adb.{oci-region-name}.oraclecloudapps.com/adb/auth/v1/databases/{database-ocid}/accesskeys/{access_key_id}
    Authorization: Basic <Base64-encoded
    database username and password>request-id: <optional request-id>

Esempio: la chiamata seguente recupera informazioni dettagliate sulla chiave di accesso specificata. In questo modo è possibile confermare gli attributi e le autorizzazioni associati alla chiave di accesso:

# Request
curl -X GET 'https://dataaccess.adb.us-phoenix-1.oraclecloudapps.com/adb/auth/v1/databases/OCID1.AUTONOMOUSDATABASE.OC1.PHX.ANYHQLJRGDV...EXAMPLE/accesskeys/ak_og67ZI8bdS.....BiHCda7l' \
--user "AdminUser:TestPass#" \
--header 'Request-Id: xcz5efdb7rfrbsfkkwwl7d38' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json'

# Sample Response
{
    "access_key_id": "ak_og67ZI8bdS.....BiHCda7l",
    "expiration_timestamp": "2025-12-07T03:35:12.751Z",
    "permissions": [
        {
            "actions": [
                "ADMIN_ANY"
            ]
        }
    ]
}

Parametri di richiesta:

• database-ocid: l'OCID (Oracle Cloud Identifier) univoco dell'Autonomous Database su cui viene eseguita una query.

• access-key-id: l'identificativo univoco della chiave di accesso specifica i cui dettagli sono richiesti.

• AdminUser: il nome utente del database utilizzato per l'autenticazione.

• TestPass#: la password dell'utente del database.

• Request-Id: identificativo univoco per questa richiesta API, utile per la registrazione o la risoluzione dei problemi.

• Content-Type: specifica il formato previsto della risposta (application o json; impostato nell'intestazione).

• Accept: specifica il formato della risposta.

Aggiornare una chiave di accesso

Dopo aver creato e recuperato la chiave di accesso, utilizzare l'API REST PUT /accesskeys per aggiornare gli attributi di una chiave di accesso esistente.

Sintassi ed esempio per aggiornare una chiave di accesso:

Sintassi

PUT https://dataaccess.adb.{oci-region-name}.oraclecloudapps.com/adb/auth/v1/databases/{database-ocid}/accesskeys/{access_key_id}
    Authorization: Basic <Base64-encoded database username and password>
    request-id: <optional request-id>
    Content-Type: application/json

{
  "permissions": [<permissions array>],
  "extend_expiration_minutes_by": <integer>
}

Esempio: la richiesta seguente aggiorna la chiave di accesso per estendere il tempo di scadenza di 120 minuti.

# Request
curl -X PUT 'https://dataaccess.adb.us-phoenix-1.oraclecloudapps.com/adb/auth/v1/databases/OCID1.AUTONOMOUSDATABASE.OC1.PHX.ANYHQLJRGDV...EXAMPLE/accesskeys/ak_og67ZI8bdS.....BiHCda7l' \
--user "AdminUser:TestPass#" \
--header 'Request-Id: xzpqvei6e7x52ri94odpv0a4' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--data-raw '{
    "extend_expiration_minutes_by" : 120
}'

# Sample Response

{
    "access_key_id": "ak_og67ZI8bdS.....BiHCda7l",
    "expiration_timestamp": "2025-12-07T05:35:12.751Z",
    "permissions": [
        {
            "actions": [
                "ADMIN_ANY"
            ]
        }
    ],
    "message": "Expiration extended by 120 min"
}

Parametri richiesta:

• database-ocid: l'OCID (Oracle Cloud Identifier) univoco dell'Autonomous Database su cui viene eseguita una query.

• access-key-id: l'identificativo univoco della chiave di accesso specifica i cui dettagli sono richiesti.

• AdminUser: il nome utente del database utilizzato per l'autenticazione.

• TestPass#: la password dell'utente del database.

• Request-Id: identificativo univoco per questa richiesta API, utile per la registrazione o la risoluzione dei problemi.

• Content-Type: specifica il formato previsto della risposta (application o json; impostato nell'intestazione).

• Accept: specifica il formato della risposta.

• extend_expiration_minutes_by: (Corpo) Numero di minuti per estendere la scadenza della chiave di accesso.

Parametri risposta:

• access_key_id: l'identificativo univoco della chiave di accesso aggiornata.

• expiration_timestamp: il nuovo indicatore orario di scadenza per la chiave di accesso.

• permissions: array che descrive le autorizzazioni associate alla chiave di accesso.

  • actions: elenco delle azioni consentite (ad esempio, "ADMIN_ANY").

• message: messaggio di conferma che indica l'azione eseguita.

Elimina una chiave di accesso

È possibile eliminare una chiave di accesso esistente quando non è più necessaria. Per rimuovere una chiave di accesso dal database, utilizzare l'API REST DELETE /accesskeys.

Sintassi ed esempio per rimuovere una chiave di accesso dal database:

Sintassi:

DELETE https://dataaccess.adb.{oci-region-name}.oraclecloudapps.com/adb/auth/v1/databases/{database-ocid}/accesskeys/{access_key_id}
    Authorization: Basic <Base64-encoded database username and password>
    request-id: <optional request-id>

Esempio: la richiesta seguente rimuove la chiave di accesso specificata da Autonomous AI Database. Una volta eliminata, la chiave non può più essere utilizzata per l'autenticazione o l'accesso al database. Un'eliminazione riuscita restituisce un codice di stato HTTP 204 No Content o 200 OK, senza corpo della risposta.

# Request
curl -X DELETE 'https://dataaccess.adb.us-phoenix-1.oraclecloudapps.com/adb/auth/v1/databases/OCID1.AUTONOMOUSDATABASE.OC1.PHX.ANYHQLJRGDV...EXAMPLE/accesskeys/ak_og67ZI8bdS.....BiHCda7l' \
--user "AdminUser:TestPass#" \
--header 'Request-Id: xzpqvei6e7x52ri94odpv0a4' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
# Sample Response

{
    "message": "Access key deleted successfully.",
    "access_key_id": "ak_og67ZI8bdS.....BiHCda7l",
    "status": "DELETED"
}

Parametri richiesta:

• database-ocid: l'OCID (Oracle Cloud Identifier) univoco dell'Autonomous Database su cui viene eseguita una query.

• access-key-id: l'identificativo univoco della chiave di accesso specifica i cui dettagli sono richiesti.

• AdminUser: il nome utente del database utilizzato per l'autenticazione.

• TestPass#: la password dell'utente del database.

• Request-Id: identificativo univoco per questa richiesta API, utile per la registrazione o la risoluzione dei problemi.

• Content-Type: specifica il formato previsto della risposta (application o json; impostato nell'intestazione).

Parametri risposta:

• message: messaggio di conferma che indica il risultato dell'operazione di eliminazione.

• access_key_id: l'identificativo univoco della chiave di accesso aggiornata.

• status: lo stato finale della chiave di accesso dopo la cancellazione (ad esempio, "DELETED").

Per configurare il client DynamoDB per richiamare l'API di Autonomous AI Database per DynamoDB, effettuare le operazioni riportate di seguito.

Configurare DynamoDbClient con Autonomous AI Database DynamoDB - Endpoint compatibile

Aggiorna file credenziali AWS

aws_access_key_id=<Your ADB-S DynamoDB Compatible APIs Access Key ID>
aws_secret_access_key=<Your ADB-S DynamoDB Compatible APIs Secret Access Key>

Aggiornare il codice client DynamoDB per utilizzare l'endpoint di Autonomous AI Database.

Ad esempio, il codice seguente configura il client DynamoDB utilizzando l'SDK Java per puntare all'endpoint di Autonomous AI Database:

import java.net.URI;
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.dynamodb.DynamoDbClient;

// Set the appropriate region and endpoint. 
//Region name is optional and will be overridden by the region value specified in the REST API endpoint.
Region region = Region.US_EAST_1;
String endpoint = "https://dataaccess.adb.us-phoenix-1.oraclecloudapps.com/adb/keyvaluestore/v1/OCID1.AUTONOMOUSDATABASE.OC1.PHX.ANYHQLJRGDV...EXAMPLE";

// Build the DynamoDB client using a custom endpoint
DynamoDbClient ddb = DynamoDbClient.builder()
    .region(region)
    .endpointOverride(URI.create(endpoint))
    .build();

Questo esempio sostituisce l'endpoint predefinito in modo che il client punti all'endpoint REST compatibile con Autonomous AI Database DynamoDB.

Elementi codice:

• DynamoDbClient.builder(): inizializza una nuova istanza DynamoDbClient.Builder. Questo builder fa parte dell'SDK AWS per Java e viene utilizzato per la creazione di istanze client DynamoDB.

• region(Region region): specifica l'area AWS in cui opera il client. Tenere presente che questo nome di area è facoltativo e verrà sostituito dal valore di area specificato nell'endpoint API REST.

• endpointOverride(URI endpoint): configura il client per comunicare con un endpoint HTTP compatibile con DynamoDB specificato, anziché con l'endpoint del servizio AWS predefinito.

• build(): finalizza la configurazione della Costruzione guidata e crea una nuova istanza DynamoDbClient con le impostazioni specificate.

Puoi anche configurare o sostituire l'endpoint client DynamoDB utilizzando altri linguaggi di programmazione e i rispettivi SDK AWS, come Python (con Boto3), C++.

Richiama l'API compatibile con DynamoDB su Autonomous AI Database

Il codice seguente mostra come creare una tabella movie compatibile con DynamoDB ed eseguire operazioni di base: descrivere, elencare, inserire, aggiornare ed eliminare elementi utilizzando l'SDK v2 di Java AWS con un endpoint personalizzato.

import software.amazon.awssdk.services.dynamodb.DynamoDbClient;
import software.amazon.awssdk.services.dynamodb.model.*;
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.dynamodb.model.AttributeValue;
import java.net.URI;
import java.util.Map;

public class DynamoDBMovieExample {
    public static void main(String[] args) {
        // Set the region and endpoint
        //Region name is optional and will be overridden by the region value specified in the REST API endpoint.
        Region region = Region.US_WEST_1;
        String endpoint = "https://region.us-phoenix-1.adb.oraclecloud.com";

        // Build the DynamoDB client using a custom endpoint
        DynamoDbClient ddb = DynamoDbClient.builder()
            .region(region)
            .endpointOverride(URI.create(endpoint))
            .build();

        // Create table
        CreateTableRequest createTableRequest = CreateTableRequest.builder()
            .tableName("movie")
            .keySchema(
                KeySchemaElement.builder().attributeName("PK").keyType(KeyType.HASH).build(),
                KeySchemaElement.builder().attributeName("SK").keyType(KeyType.RANGE).build()
            )
            .attributeDefinitions(
                AttributeDefinition.builder().attributeName("PK").attributeType(ScalarAttributeType.S).build(),
                AttributeDefinition.builder().attributeName("SK").attributeType(ScalarAttributeType.S).build()
            )
            .provisionedThroughput(
                ProvisionedThroughput.builder().readCapacityUnits(5L).writeCapacityUnits(5L).build()
            )
            .build();
        ddb.createTable(createTableRequest);

        // Describe the table
        DescribeTableRequest descRequest = DescribeTableRequest.builder().tableName("movie").build();
        DescribeTableResponse descResponse = ddb.describeTable(descRequest);

        // List all tables
        ListTablesRequest listRequest = ListTablesRequest.builder().build();
        ListTablesResponse listResponse = ddb.listTables(listRequest);

        // Insert (PutItem)
        ddb.putItem(PutItemRequest.builder()
            .tableName("movie")
            .item(Map.of(
                "PK", AttributeValue.builder().s("001").build(),
                "SK", AttributeValue.builder().s("MOVIE").build(),
                "Title", AttributeValue.builder().s("Inception").build()))
            .build()
        );

        // Update (UpdateItem)
        ddb.updateItem(UpdateItemRequest.builder()
            .tableName("movie")
            .key(Map.of(
                "PK", AttributeValue.builder().s("001").build(),
                "SK", AttributeValue.builder().s("MOVIE").build()))
            .updateExpression("SET #T = :t")
            .expressionAttributeNames(Map.of("#T", "Title"))
            .expressionAttributeValues(Map.of(":t", AttributeValue.builder().s("Inception (2010)").build()))
            .build()
        );

        // Delete (DeleteItem)
        ddb.deleteItem(DeleteItemRequest.builder()
            .tableName("movie")
            .key(Map.of(
                "PK", AttributeValue.builder().s("001").build(),
                "SK", AttributeValue.builder().s("MOVIE").build()))
            .build()
        );
    }
}

Note sull'uso

Limiti