Dps Certificate - Create Or Update

Riferimento

Servizio:: IoT Hub Device Provisioning Service

Versione API:: 2022-12-12

Caricare il certificato nel servizio di provisioning.
Aggiungere un nuovo certificato o aggiornare un certificato esistente.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/provisioningServices/{provisioningServiceName}/certificates/{certificateName}?api-version=2022-12-12

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
certificateName	path	True	string	Nome del certificato creato o aggiornato.
provisioningServiceName	path	True	string	Nome del servizio di provisioning.
resourceGroupName	path	True	string	Identificatore del gruppo di risorse.
subscriptionId	path	True	string	L'identificatore della sottoscrizione.
api-version	query	True	string	Versione dell'API.

Intestazione della richiesta

Nome	Necessario	Tipo	Descrizione
If-Match		string	ETag del certificato. Questa operazione è necessaria per aggiornare un certificato esistente e ignorare durante la creazione di un nuovo certificato.

Corpo della richiesta

Nome	Tipo	Descrizione
properties	CertificateProperties	proprietà di un certificato

Risposte

Nome	Tipo	Descrizione
200 OK	CertificateResponse	Se il certificato esiste già e l'aggiornamento ha avuto esito positivo, l'operazione restituisce il codice di stato HTTP 201 (OK).
Other Status Codes	ErrorDetails	Risposta di errore predefinita.

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

DPSCreateOrUpdateCertificate

Esempio di richiesta

HTTP

PUT https://management.azure.com/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/provisioningServices/myFirstProvisioningService/certificates/cert?api-version=2022-12-12

{
  "properties": {
    "certificate": "MA=="
  }
}

Risposta di esempio

Codice di stato:: 200

{
  "properties": {
    "subject": "CN=testdevice1",
    "expiry": "Sat, 31 Dec 2039 23:59:59 GMT",
    "certificate": "MA==",
    "thumbprint": "97388663832D0393C9246CAB4FBA2C8677185A25",
    "isVerified": false,
    "created": "Thu, 12 Oct 2017 19:23:50 GMT",
    "updated": "Thu, 12 Oct 2017 19:23:50 GMT"
  },
  "id": "/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/ProvisioningServives/myFirstProvisioningService/certificates/cert",
  "name": "cert",
  "type": "Microsoft.Devices/ProvisioningServices/Certificates",
  "etag": "AAAAAAExpNs="
}

Definizioni

Nome	Descrizione
CertificateProperties	Descrizione di un certificato CA X509.
CertificateResponse	Certificato X509.
createdByType	Tipo di identità che ha creato la risorsa.
ErrorDetails	Dettagli degli errori.
systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.

CertificateProperties

Descrizione di un certificato CA X509.

Nome	Tipo	Descrizione
certificate	string	rappresentazione base-64 del certificato X509 .cer file o semplicemente contenuto di file pem.
created	string	Data e ora di creazione del certificato.
expiry	string	Data e ora di scadenza del certificato.
isVerified	boolean	Determina se il certificato è stato verificato.
subject	string	Nome soggetto del certificato.
thumbprint	string	identificazione personale del certificato.
updated	string	Data e ora dell'ultimo aggiornamento del certificato.

CertificateResponse

Certificato X509.

Nome	Tipo	Descrizione
etag	string	Il tag di entità.
id	string	Identificatore di risorsa.
name	string	Nome del certificato.
properties	CertificateProperties	proprietà di un certificato
systemData	systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.
type	string	Tipo di risorsa.

createdByType

Tipo di identità che ha creato la risorsa.

Nome	Tipo	Descrizione
Application	string
Key	string
ManagedIdentity	string
User	string

ErrorDetails

Dettagli degli errori.

Nome	Tipo	Descrizione
code	integer	Codice di errore.
details	string	Dettagli dell'errore.
httpStatusCode	string	Codice di stato HTTP.
message	string	Messaggio di errore.

systemData

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

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

Condividi tramite