Dps Certificate - Create Or Update

Szolgáltatás:

IoT Hub Device Provisioning Service

API-verzió:

2022-12-12

Töltse fel a tanúsítványt a kiépítési szolgáltatásba.
Adjon hozzá új tanúsítványt, vagy frissítsen egy meglévő tanúsítványt.

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
certificateName	path	True	string	A tanúsítvány létrehozása vagy frissítése.
provisioningServiceName	path	True	string	A kiépítési szolgáltatás neve.
resourceGroupName	path	True	string	Erőforráscsoport azonosítója.
subscriptionId	path	True	string	Az előfizetés azonosítója.
api-version	query	True	string	Az API verziója.

Kérelem fejléce

Name	Kötelező	Típus	Description
If-Match		string	A tanúsítvány ETagje. Ez szükséges egy meglévő tanúsítvány frissítéséhez, és figyelmen kívül hagyva egy teljesen új tanúsítvány létrehozásakor.

Kérelem törzse

Name	Típus	Description
properties	CertificateProperties	tanúsítvány tulajdonságai

Válaszok

Name	Típus	Description
200 OK	CertificateResponse	Ha a tanúsítvány már létezik, és a frissítés sikeres volt, a művelet a 201(OK) HTTP-állapotkódot adja vissza.
Other Status Codes	ErrorDetails	Alapértelmezett hibaválasz.

Biztonság

azure_auth

Azure Active Directory OAuth2 Flow.

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Name	Description
user_impersonation	felhasználói fiók megszemélyesítése

Példák

DPSCreateOrUpdateCertificate

Mintakérelem

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

Mintaválasz

Állapotkó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="
}

Definíciók

Name	Description
CertificateProperties	Az X509 hitelesítésszolgáltatói tanúsítvány leírása.
CertificateResponse	Az X509-tanúsítvány.
createdByType	Az erőforrást létrehozó identitás típusa.
ErrorDetails	Hiba részletei.
systemData	Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

CertificateProperties

Az X509 hitelesítésszolgáltatói tanúsítvány leírása.

Name	Típus	Description
certificate	string	Az X509-tanúsítvány base-64-es reprezentációja .cer fájl vagy csak .pem fájltartalom.
created	string	A tanúsítvány létrehozásának dátuma és időpontja.
expiry	string	A tanúsítvány lejárati dátuma és időpontja.
isVerified	boolean	Meghatározza, hogy a tanúsítvány ellenőrizve lett-e.
subject	string	A tanúsítvány tulajdonosának neve.
thumbprint	string	A tanúsítvány ujjlenyomata.
updated	string	A tanúsítvány utolsó frissítési dátuma és időpontja.

CertificateResponse

Az X509-tanúsítvány.

Name	Típus	Description
etag	string	Az entitáscímke.
id	string	Az erőforrás azonosítója.
name	string	A tanúsítvány neve.
properties	CertificateProperties	tanúsítvány tulajdonságai
systemData	systemData	Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.
type	string	Az erőforrás típusa.

createdByType

Az erőforrást létrehozó identitás típusa.

Name	Típus	Description
Application	string
Key	string
ManagedIdentity	string
User	string

ErrorDetails

Hiba részletei.

Name	Típus	Description
code	integer	A hibakód.
details	string	A hiba részletei.
httpStatusCode	string	A HTTP-állapotkód.
message	string	A hibaüzenet.

systemData

Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

Name	Típus	Description
createdAt	string	Az erőforrás-létrehozás időbélyege (UTC).
createdBy	string	Az erőforrást létrehozó identitás.
createdByType	createdByType	Az erőforrást létrehozó identitás típusa.
lastModifiedAt	string	Az erőforrás utolsó módosításának időbélyege (UTC)
lastModifiedBy	string	Az erőforrást utoljára módosító identitás.
lastModifiedByType	createdByType	Az erőforrást legutóbb módosító identitás típusa.