Dps Certificate - Create Or Update

Referens

Tjänst:: IoT Hub Device Provisioning Service

API-version:: 2022-12-12

Ladda upp certifikatet till etableringstjänsten.
Lägg till ett nytt certifikat eller uppdatera ett befintligt certifikat.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
certificateName	path	True	string	Namnet på certifikatet skapa eller uppdatera.
provisioningServiceName	path	True	string	Namnet på etableringstjänsten.
resourceGroupName	path	True	string	Resursgruppsidentifierare.
subscriptionId	path	True	string	Prenumerationsidentifieraren.
api-version	query	True	string	Versionen av API:et.

Begärandehuvud

Name	Obligatorisk	Typ	Description
If-Match		string	ETag för certifikatet. Detta krävs för att uppdatera ett befintligt certifikat och ignoreras när du skapar ett helt nytt certifikat.

Begärandetext

Name	Typ	Description
properties	CertificateProperties	egenskaper för ett certifikat

Svar

Name	Typ	Description
200 OK	CertificateResponse	Om certifikatet redan finns och uppdateringen lyckades returnerar åtgärden HTTP-statuskoden 201 (OK).
Other Status Codes	ErrorDetails	Standardfelsvar.

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name	Description
user_impersonation	personifiera ditt användarkonto

Exempel

DPSCreateOrUpdateCertificate

Exempelbegäran

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

Exempelsvar

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

Definitioner

Name	Description
CertificateProperties	Beskrivningen av ett X509 CA-certifikat.
CertificateResponse	X509-certifikatet.
createdByType	Den typ av identitet som skapade resursen.
ErrorDetails	Felinformation.
systemData	Metadata som rör skapande och senaste ändring av resursen.

CertificateProperties

Beskrivningen av ett X509 CA-certifikat.

Name	Typ	Description
certificate	string	base-64-representation av X509-certifikatet .cer fil eller bara .pem-filinnehåll.
created	string	Certifikatets skapandedatum och tid.
expiry	string	Certifikatets förfallodatum och tid.
isVerified	boolean	Avgör om certifikatet har verifierats.
subject	string	Certifikatets ämnesnamn.
thumbprint	string	Certifikatets tumavtryck.
updated	string	Certifikatets senaste uppdateringsdatum och -tid.

CertificateResponse

X509-certifikatet.

Name	Typ	Description
etag	string	Entitetstaggen.
id	string	Resursidentifieraren.
name	string	Namnet på certifikatet.
properties	CertificateProperties	egenskaper för ett certifikat
systemData	systemData	Metadata som rör skapande och senaste ändring av resursen.
type	string	Resurstypen.

createdByType

Den typ av identitet som skapade resursen.

Name	Typ	Description
Application	string
Key	string
ManagedIdentity	string
User	string

ErrorDetails

Felinformation.

Name	Typ	Description
code	integer	Felkoden.
details	string	Felinformationen.
httpStatusCode	string	HTTP-statuskoden.
message	string	Felmeddelandet.

systemData

Metadata som rör skapande och senaste ändring av resursen.

Name	Typ	Description
createdAt	string	Tidsstämpeln för resursskapande (UTC).
createdBy	string	Identiteten som skapade resursen.
createdByType	createdByType	Den typ av identitet som skapade resursen.
lastModifiedAt	string	Tidsstämpeln för resursens senaste ändring (UTC)
lastModifiedBy	string	Identiteten som senast ändrade resursen.
lastModifiedByType	createdByType	Den typ av identitet som senast ändrade resursen.

Dela via