Graph Resources - Create Update Graph

Creare o aggiornare un Graph di database di Azure Cosmos.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/graphs/{graphName}?api-version=2021-07-01-preview

Parametri dell'URI

Name In Required Type Description
accountName
path True
  • string

Cosmos nome dell'account del database di database.

Regex pattern: ^[a-z0-9]+(-[a-z0-9]+)*

graphName
path True
  • string

Cosmos nome della risorsa del grafo del database.

resourceGroupName
path True
  • string

Nome del gruppo di risorse. Per il nome non viene fatta distinzione tra maiuscole e minuscole.

subscriptionId
path True
  • string

ID della sottoscrizione di destinazione.

api-version
query True
  • string

Versione dell'API da usare per questa operazione.

Corpo della richiesta

Name Required Type Description
properties.resource True

Formato JSON standard di una risorsa Graph

identity

Identità per la risorsa.

location
  • string

Posizione del gruppo di risorse a cui appartiene la risorsa.

properties.options

Coppia chiave-valore di opzioni da applicare per la richiesta. Corrisponde alle intestazioni inviate con la richiesta.

tags
  • object

I tag sono un elenco di coppie chiave-valore che descrivono la risorsa. Questi tag possono essere utilizzati nella visualizzazione e nel raggruppamento di questa risorsa (tra gruppi di risorse). È possibile specificare un massimo di 15 tag per una risorsa. Ogni tag deve avere una chiave non superiore a 128 caratteri con un valore che non superi i 256 caratteri. Ad esempio, l'esperienza predefinita per un tipo di modello è impostata con "defaultExperience": "Cassandra". I valori correnti "defaultExperience" includono anche "Table", "Graph", "DocumentDB" e "MongoDB".

Risposte

Name Type Description
200 OK

Il Graph'operazione di creazione o aggiornamento è stata completata correttamente.

202 Accepted

L'operazione di creazione o aggiornamento del grafico verrà completata in modo asincrono.

Sicurezza

azure_auth

Azure Active Directory Flow OAuth2

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation Rappresentare l'account utente

Esempio

CosmosDBGraphCreateUpdate

Sample Request

PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/graphs/graphName?api-version=2021-07-01-preview

{
  "location": "West US",
  "tags": {},
  "properties": {
    "resource": {
      "id": "graphName"
    },
    "options": {}
  }
}

Sample Response

{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/graphs/graphName",
  "name": "graphName",
  "type": "Microsoft.DocumentDB/databaseAccounts/graphs",
  "location": "West US",
  "tags": {},
  "properties": {
    "resource": {
      "id": "graphName"
    }
  }
}

Definizioni

AutoscaleSettings
CreateUpdateOptions

CreateUpdateOptions è un elenco di coppie chiave-valore che descrivono la risorsa. Le chiavi supportate sono "If-Match", "If-None-Match", "Session-Token" e "Throughput"

GraphResource

oggetto risorsa Graph database Cosmos

GraphResourceCreateUpdateParameters

Parametri per creare e aggiornare Cosmos risorsa di database Graph.

GraphResourceGetResults

Una risorsa di Graph database di Azure Cosmos.

ManagedServiceIdentity

Identità per la risorsa.

Options
Resource
ResourceIdentityType

Tipo di identità usata per la risorsa. Il tipo 'SystemAssigned,UserAssigned' include sia un'identità creata in modo implicito che un set di identità assegnate dall'utente. Il tipo "Nessuno" rimuoverà le identità dal servizio.

UserAssignedIdentities

Elenco di identità utente associate alla risorsa. I riferimenti alla chiave del dizionario identità utente saranno ID risorsa ARM nel formato :'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.

AutoscaleSettings

Name Type Description
maxThroughput
  • integer

Rappresenta la velocità effettiva massima, la risorsa può aumentare le prestazioni.

CreateUpdateOptions

CreateUpdateOptions è un elenco di coppie chiave-valore che descrivono la risorsa. Le chiavi supportate sono "If-Match", "If-None-Match", "Session-Token" e "Throughput"

Name Type Description
autoscaleSettings

Specifica le impostazioni di scalabilità automatica.

throughput
  • integer

Unità richiesta al secondo. Ad esempio, "velocità effettiva": 10000.

GraphResource

oggetto risorsa Graph database Cosmos

Name Type Description
id
  • string

Nome del Graph del database Cosmos

GraphResourceCreateUpdateParameters

Parametri per creare e aggiornare Cosmos risorsa di database Graph.

Name Type Description
id
  • string

Identificatore univoco della risorsa arm.

identity

Identità per la risorsa.

location
  • string

Posizione del gruppo di risorse a cui appartiene la risorsa.

name
  • string

Nome della risorsa arm.

properties.options

Coppia chiave-valore di opzioni da applicare per la richiesta. Corrisponde alle intestazioni inviate con la richiesta.

properties.resource

Formato JSON standard di una risorsa Graph

tags
  • object

I tag sono un elenco di coppie chiave-valore che descrivono la risorsa. Questi tag possono essere utilizzati nella visualizzazione e nel raggruppamento di questa risorsa (tra gruppi di risorse). È possibile specificare un massimo di 15 tag per una risorsa. Ogni tag deve avere una chiave non superiore a 128 caratteri con un valore che non superi i 256 caratteri. Ad esempio, l'esperienza predefinita per un tipo di modello è impostata con "defaultExperience": "Cassandra". I valori correnti "defaultExperience" includono anche "Table", "Graph", "DocumentDB" e "MongoDB".

type
  • string

Tipo di risorsa di Azure.

GraphResourceGetResults

Una risorsa di Graph database di Azure Cosmos.

Name Type Description
id
  • string

Identificatore univoco della risorsa arm.

identity

Identità per la risorsa.

location
  • string

Posizione del gruppo di risorse a cui appartiene la risorsa.

name
  • string

Nome della risorsa arm.

properties.options
properties.resource
tags
  • object

I tag sono un elenco di coppie chiave-valore che descrivono la risorsa. Questi tag possono essere utilizzati nella visualizzazione e nel raggruppamento di questa risorsa (tra gruppi di risorse). È possibile specificare un massimo di 15 tag per una risorsa. Ogni tag deve avere una chiave non superiore a 128 caratteri con un valore che non superi i 256 caratteri. Ad esempio, l'esperienza predefinita per un tipo di modello è impostata con "defaultExperience": "Cassandra". I valori correnti "defaultExperience" includono anche "Table", "Graph", "DocumentDB" e "MongoDB".

type
  • string

Tipo di risorsa di Azure.

ManagedServiceIdentity

Identità per la risorsa.

Name Type Description
principalId
  • string

ID dell'entità dell'identità assegnata dal sistema. Questa proprietà verrà fornita solo per un'identità assegnata dal sistema.

tenantId
  • string

ID tenant dell'identità assegnata dal sistema. Questa proprietà verrà fornita solo per un'identità assegnata dal sistema.

type

Tipo di identità usata per la risorsa. Il tipo 'SystemAssigned,UserAssigned' include sia un'identità creata in modo implicito che un set di identità assegnate dall'utente. Il tipo "Nessuno" rimuoverà le identità dal servizio.

userAssignedIdentities

Elenco di identità utente associate alla risorsa. I riferimenti alla chiave del dizionario identità utente saranno ID risorsa ARM nel formato :'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.

Options

Name Type Description
autoscaleSettings

Specifica le impostazioni di scalabilità automatica.

throughput
  • integer

Valore della velocità effettiva della risorsa del database Cosmos o di autoscaleSettings. Usare la risorsa ThroughputSetting durante il recupero dei dettagli dell'offerta.

Resource

Name Type Description
id
  • string

Nome del Graph del database Cosmos

ResourceIdentityType

Tipo di identità usata per la risorsa. Il tipo 'SystemAssigned,UserAssigned' include sia un'identità creata in modo implicito che un set di identità assegnate dall'utente. Il tipo "Nessuno" rimuoverà le identità dal servizio.

Name Type Description
None
  • string
SystemAssigned
  • string
SystemAssigned,UserAssigned
  • string
UserAssigned
  • string

UserAssignedIdentities

Elenco di identità utente associate alla risorsa. I riferimenti alla chiave del dizionario identità utente saranno ID risorsa ARM nel formato :'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.

Name Type Description