Accounts - Create

Servizio:: Data Share

Versione API:: 2021-08-01

Creare un account nel gruppo di risorse specificato

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}?api-version=2021-08-01

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
accountName	path	True	string	Nome dell'account di condivisione.
resourceGroupName	path	True	string	Nome del gruppo di risorse.
subscriptionId	path	True	string	Identificatore della sottoscrizione
api-version	query	True	string	Versione dell'API da usare.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
identity	True	Identity	Informazioni sull'identità nell'account
location		string	Posizione della risorsa di Azure.
tags		object	Tag nella risorsa di Azure.

Risposte

Nome	Tipo	Descrizione
200 OK	Account	Successo
201 Created	Account	Successo
Other Status Codes	DataShareError	Risposta di errore ricevuta dal provider di risorse Microsoft.DataShare.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

Accounts_Create

Esempio di richiesta

HTTP

PUT https://management.azure.com/subscriptions/433a8dfd-e5d5-4e77-ad86-90acdc75eb1a/resourceGroups/SampleResourceGroup/providers/Microsoft.DataShare/accounts/Account1?api-version=2021-08-01

{
  "location": "West US 2",
  "tags": {
    "tag1": "Red",
    "tag2": "White"
  },
  "identity": {
    "type": "SystemAssigned"
  }
}

Risposta di esempio

Codice di stato:: 201

Date: Wed, 13 Sep 2017 18:04:32 GMT
x-ms-request-id: d5496da4-9c52-402f-b067-83cc9ddea888
X-Content-Type-Options: nosniff
x-ms-ratelimit-remaining-tenant-reads: 14999
x-ms-correlation-request-id: 25c78f97-0b0a-4fe9-ad39-883a482265cd

{
  "properties": {
    "userName": "John Smith",
    "createdAt": "2018-11-14T04:47:52.9614956Z",
    "userEmail": "johnsmith@microsoft.com"
  },
  "location": "West US 2",
  "tags": {
    "tag1": "Red",
    "tag2": "White"
  },
  "systemData": {
    "createdBy": "user1",
    "createdByType": "User",
    "createdAt": "2020-01-01T17:18:19.1234567Z",
    "lastModifiedBy": "user2",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2020-01-02T17:18:19.1234567Z"
  },
  "identity": {
    "type": "SystemAssigned"
  },
  "id": "/subscriptions/433a8dfd-e5d5-4e77-ad86-90acdc75eb1a/resourceGroups/SampleResourceGroup/providers/Microsoft.DataShare/accounts/Account1",
  "name": "Account1",
  "type": "Microsoft.DataShare/accounts"
}

Codice di stato:: 200

Date: Wed, 13 Sep 2017 18:04:32 GMT
x-ms-request-id: d5496da4-9c52-402f-b067-83cc9ddea888
X-Content-Type-Options: nosniff
x-ms-ratelimit-remaining-tenant-reads: 14999
x-ms-correlation-request-id: 25c78f97-0b0a-4fe9-ad39-883a482265cd

{
  "properties": {
    "userName": "John Smith",
    "createdAt": "2018-11-14T04:47:52.9614956Z",
    "userEmail": "johnsmith@microsoft.com"
  },
  "location": "West US 2",
  "tags": {
    "tag1": "Red",
    "tag2": "White"
  },
  "systemData": {
    "createdBy": "user1",
    "createdByType": "User",
    "createdAt": "2020-01-01T17:18:19.1234567Z",
    "lastModifiedBy": "user2",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2020-01-02T17:18:19.1234567Z"
  },
  "identity": {
    "type": "SystemAssigned"
  },
  "id": "/subscriptions/433a8dfd-e5d5-4e77-ad86-90acdc75eb1a/resourceGroups/SampleResourceGroup/providers/Microsoft.DataShare/accounts/Account1",
  "name": "Account1",
  "type": "Microsoft.DataShare/accounts"
}

Definizioni

Nome	Descrizione
Account	Oggetto trasferimento dati dell'account.
createdByType	Tipo di identità che ha creato la risorsa.
DataShareError	Modello di errore di condivisione dati.
DataShareErrorInfo	Modello del corpo dell'errore di condivisione dati.
Identity	Identità della risorsa
lastModifiedByType	Tipo di identità che ha modificato l'ultima volta la risorsa.
provisioningState	Stato di provisioning dell'account
SystemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.
type	Tipo di identità

Account

Object

Oggetto trasferimento dati dell'account.

Nome	Tipo	Descrizione
id	string	ID risorsa della risorsa di Azure
identity	Identity	Informazioni sull'identità nell'account
location	string	Posizione della risorsa di Azure.
name	string	Nome della risorsa di Azure
properties.createdAt	string (date-time)	Ora di creazione dell'account.
properties.provisioningState	provisioningState	Stato di provisioning dell'account
properties.userEmail	string	Indirizzo di posta elettronica dell'utente che ha creato la risorsa
properties.userName	string	Nome dell'utente che ha creato la risorsa
systemData	SystemData	Dati di sistema della risorsa di Azure.
tags	object	Tag nella risorsa di Azure.
type	string	Tipo di risorsa di Azure

createdByType

Enumerazione

Tipo di identità che ha creato la risorsa.

Valore	Descrizione
User
Application
ManagedIdentity
Key

DataShareError

Object

Modello di errore di condivisione dati.

Nome	Tipo	Descrizione
error	DataShareErrorInfo	Corpo dell'errore di condivisione dati

DataShareErrorInfo

Object

Modello del corpo dell'errore di condivisione dati.

Nome	Tipo	Descrizione
code	string	Codice dell'errore
details	DataShareErrorInfo[]	Dettagli annidati del modello di errore
message	string	Messaggio dell'errore
target	string	Destinazione dell'errore

Identity

Object

Identità della risorsa

Nome	Tipo	Descrizione
principalId	string	ID entità servizio
tenantId	string	ID inquilino
type	type	Tipo di identità

lastModifiedByType

Enumerazione

Tipo di identità che ha modificato l'ultima volta la risorsa.

Valore	Descrizione
User
Application
ManagedIdentity
Key

provisioningState

Enumerazione

Stato di provisioning dell'account

Valore	Descrizione
Succeeded
Creating
Deleting
Moving
Failed

SystemData

Object

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome	Tipo	Descrizione
createdAt	string (date-time)	Timestamp della creazione della risorsa (UTC).
createdBy	string	Identità che ha creato la risorsa.
createdByType	createdByType	Tipo di identità che ha creato la risorsa.
lastModifiedAt	string (date-time)	Tipo di identità che ha modificato l'ultima volta la risorsa.
lastModifiedBy	string	Identità che ha modificato l'ultima volta la risorsa.
lastModifiedByType	lastModifiedByType	Tipo di identità che ha modificato l'ultima volta la risorsa.

type

Enumerazione

Tipo di identità

Valore	Descrizione
SystemAssigned

Condividi tramite

Accounts - Create

Parametri dell'URI

Corpo della richiesta

Risposte

Sicurezza

azure_auth

Ambiti

Esempio

Accounts_Create

Esempio di richiesta

Risposta di esempio

Definizioni

Account

createdByType

DataShareError

DataShareErrorInfo

Identity

lastModifiedByType

provisioningState

SystemData

type