Dps Certificate - Create Or Update

Reference

Služba:: IoT Hub Device Provisioning Service

Verze rozhraní API:: 2022-12-12

Nahrajte certifikát do služby zřizování.
Přidejte nový certifikát nebo aktualizujte existující certifikát.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
certificateName	path	True	string	Název vytvoření nebo aktualizace certifikátu.
provisioningServiceName	path	True	string	Název služby zřizování.
resourceGroupName	path	True	string	Identifikátor skupiny prostředků.
subscriptionId	path	True	string	Identifikátor předplatného.
api-version	query	True	string	Verze rozhraní API

Hlavička požadavku

Name	Vyžadováno	Typ	Description
If-Match		string	Značka ETag certifikátu. To se vyžaduje k aktualizaci existujícího certifikátu a při vytváření úplně nového certifikátu se ignoruje.

Text požadavku

Name	Typ	Description
properties	CertificateProperties	vlastnosti certifikátu

Odpovědi

Name	Typ	Description
200 OK	CertificateResponse	Pokud certifikát již existuje a aktualizace proběhla úspěšně, operace vrátí stavový kód HTTP 201 (OK).
Other Status Codes	ErrorDetails	Výchozí odpověď na chybu.

Zabezpečení

azure_auth

Tok Azure Active Directory OAuth2

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name	Description
user_impersonation	zosobnění uživatelského účtu

Příklady

DPSCreateOrUpdateCertificate

Ukázkový požadavek

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=="
  }
}

Ukázková odpověď

Stavový kód:: 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="
}

Definice

Name	Description
CertificateProperties	Popis certifikátu certifikační autority X509.
CertificateResponse	Certifikát X509.
createdByType	Typ identity, která vytvořila prostředek.
ErrorDetails	Podrobnosti o chybě.
systemData	Metadata týkající se vytvoření a poslední změny prostředku

CertificateProperties

Popis certifikátu certifikační autority X509.

Name	Typ	Description
certificate	string	base-64 reprezentace certifikátu X509 .cer souboru nebo jenom obsahu souboru .pem.
created	string	Datum a čas vytvoření certifikátu
expiry	string	Datum a čas vypršení platnosti certifikátu
isVerified	boolean	Určuje, jestli byl certifikát ověřen.
subject	string	Název subjektu certifikátu.
thumbprint	string	Kryptografický otisk certifikátu.
updated	string	Datum a čas poslední aktualizace certifikátu

CertificateResponse

Certifikát X509.

Name	Typ	Description
etag	string	Značka entity.
id	string	Identifikátor prostředku.
name	string	Název certifikátu.
properties	CertificateProperties	vlastnosti certifikátu
systemData	systemData	Metadata týkající se vytvoření a poslední změny prostředku
type	string	Typ prostředku.

createdByType

Typ identity, která vytvořila prostředek.

Name	Typ	Description
Application	string
Key	string
ManagedIdentity	string
User	string

ErrorDetails

Podrobnosti o chybě.

Name	Typ	Description
code	integer	Kód chyby
details	string	Podrobnosti o chybě
httpStatusCode	string	Stavový kód HTTP
message	string	Chybová zpráva

systemData

Metadata týkající se vytvoření a poslední změny prostředku

Name	Typ	Description
createdAt	string	Časové razítko vytvoření prostředku (UTC)
createdBy	string	Identita, která prostředek vytvořila.
createdByType	createdByType	Typ identity, která vytvořila prostředek.
lastModifiedAt	string	Časové razítko poslední změny prostředku (UTC)
lastModifiedBy	string	Identita, která naposledy změnila prostředek.
lastModifiedByType	createdByType	Typ identity, která naposledy změnila prostředek.

Sdílet prostřednictvím