Dps Certificate - Create Or Update

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 maxLength: 256	Název certifikátu, který se vytvoří nebo aktualizuje.
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	ETag certifikátu. To se vyžaduje k aktualizaci existujícího certifikátu a ignorování při vytváření úplně nového certifikátu.

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ě, vrátí operace stavový kód HTTP 201 (OK).
Other Status Codes	ErrorDetails	Výchozí chybová odpověď

Zabezpečení

azure_auth

Tok OAuth2 v Azure Active Directory

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á prostředek vytvořila.
ErrorDetails	Podrobnosti o chybě
systemData	Metadata týkající se vytvoření a poslední změny prostředku.

CertificateProperties

Objekt

Popis certifikátu certifikační autority X509.

Name	Typ	Description
certificate	string (byte)	reprezentace certifikátu X509 .cer souboru base-64 nebo pouze obsahu souboru .pem.
created	string (date-time-rfc1123)	Datum a čas vytvoření certifikátu.
expiry	string (date-time-rfc1123)	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 (date-time-rfc1123)	Datum a čas poslední aktualizace certifikátu.

CertificateResponse

Objekt

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

Výčet

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

Hodnota	Description
Application
Key
ManagedIdentity
User

ErrorDetails

Objekt

Podrobnosti o chybě

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

systemData

Objekt

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

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