Partager via


IotHubCertificateDescriptionCollection.CreateOrUpdateAsync Method

Definition

Adds new or replaces existing certificate.

  • Request Path: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/IotHubs/{resourceName}/certificates/{certificateName}
  • Operation Id: Certificates_CreateOrUpdate
  • Default Api Version: 2023-06-30
  • Resource: IotHubCertificateDescriptionResource
public virtual System.Threading.Tasks.Task<Azure.ResourceManager.ArmOperation<Azure.ResourceManager.IotHub.IotHubCertificateDescriptionResource>> CreateOrUpdateAsync (Azure.WaitUntil waitUntil, string certificateName, Azure.ResourceManager.IotHub.IotHubCertificateDescriptionData data, string ifMatch = default, System.Threading.CancellationToken cancellationToken = default);
abstract member CreateOrUpdateAsync : Azure.WaitUntil * string * Azure.ResourceManager.IotHub.IotHubCertificateDescriptionData * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.ResourceManager.ArmOperation<Azure.ResourceManager.IotHub.IotHubCertificateDescriptionResource>>
override this.CreateOrUpdateAsync : Azure.WaitUntil * string * Azure.ResourceManager.IotHub.IotHubCertificateDescriptionData * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.ResourceManager.ArmOperation<Azure.ResourceManager.IotHub.IotHubCertificateDescriptionResource>>
Public Overridable Function CreateOrUpdateAsync (waitUntil As WaitUntil, certificateName As String, data As IotHubCertificateDescriptionData, Optional ifMatch As String = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of ArmOperation(Of IotHubCertificateDescriptionResource))

Parameters

waitUntil
WaitUntil

Completed if the method should wait to return until the long-running operation has completed on the service; Started if it should return after starting the operation. For more information on long-running operations, please see Azure.Core Long-Running Operation samples.

certificateName
String

The name of the certificate.

data
IotHubCertificateDescriptionData

The certificate body.

ifMatch
String

ETag of the Certificate. Do not specify for creating a brand new certificate. Required to update an existing certificate.

cancellationToken
CancellationToken

The cancellation token to use.

Returns

Exceptions

certificateName is an empty string, and was expected to be non-empty.

certificateName or data is null.

Applies to