Dela via


Digital Twins Instance - DigitalTwins Delete

Ta bort en DigitalTwinsInstance.

DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DigitalTwins/digitalTwinsInstances/{resourceName}?api-version=2023-01-31

URI-parametrar

Name I Obligatorisk Typ Description
resourceGroupName
path True

string

Namnet på resursgruppen som innehåller DigitalTwinsInstance.

resourceName
path True

string

Namnet på DigitalTwinsInstance.

Regex pattern: ^(?!-)[A-Za-z0-9-]{3,63}(?<!-)$

subscriptionId
path True

string

Prenumerationsidentifieraren.

api-version
query True

string

Version av DigitalTwinsInstance Management-API:et.

Svar

Name Typ Description
200 OK

DigitalTwinsDescription

Returneras om åtgärden avbröts eller misslyckades.

202 Accepted

DigitalTwinsDescription

Godkänd – Ta bort begäran accepterad; åtgärden slutförs asynkront.

204 No Content

Returneras när den långvariga borttagningsåtgärden har slutförts, eller om Digital Twins-instansen inte finns.

Other Status Codes

ErrorResponse

Felsvar som beskriver varför åtgärden misslyckades.

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation Personifiera ditt användarkonto

Exempel

Delete a DigitalTwinsInstance resource
Delete a DigitalTwinsInstance resource with identity

Delete a DigitalTwinsInstance resource

Sample Request

DELETE https://management.azure.com/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourceGroups/resRg/providers/Microsoft.DigitalTwins/digitalTwinsInstances/myDigitalTwinsService?api-version=2023-01-31

Sample Response

{
  "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/digitalTwinsInstances/myDigitalTwinsService",
  "location": "westus2",
  "type": "Microsoft.DigitalTwins/digitalTwinsInstances",
  "name": "myDigitalTwinsService",
  "systemData": {
    "createdBy": "user@example.com",
    "createdByType": "User",
    "createdAt": "2021-03-11T17:13:59.4037715Z",
    "lastModifiedBy": "user@example.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2021-03-11T17:14:02.5281409Z"
  },
  "properties": {
    "createdTime": "2019-11-19T12:55:05.229Z",
    "lastUpdatedTime": "2019-12-06T12:21:58.610Z",
    "provisioningState": "Failed",
    "hostName": "https://myDigitalTwinsService.api.wus2.ss.azuredigitaltwins-test.net"
  }
}
azure-asyncoperation: https://management.azure.com/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/providers/Microsoft.DigitalTwins/locations/westus2/operationStatuses/12345678-1234-1234-123456789012
location: https://management.azure.com/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/providers/Microsoft.DigitalTwins/locations/westus2/operationResults/12345678-1234-1234-123456789012
retry-after: 10
{
  "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/digitalTwinsInstances/myDigitalTwinsService",
  "location": "westus2",
  "type": "Microsoft.DigitalTwins/digitalTwinsInstances",
  "name": "myDigitalTwinsService",
  "systemData": {
    "createdBy": "user@example.com",
    "createdByType": "User",
    "createdAt": "2021-03-11T17:13:59.4037715Z",
    "lastModifiedBy": "user@example.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2021-03-11T17:14:02.5281409Z"
  },
  "properties": {
    "createdTime": "2019-11-19T12:55:05.229Z",
    "lastUpdatedTime": "2019-12-06T12:21:58.610Z",
    "provisioningState": "Deleting",
    "hostName": "https://myDigitalTwinsService.api.wus2.ss.azuredigitaltwins-test.net"
  }
}

Delete a DigitalTwinsInstance resource with identity

Sample Request

DELETE https://management.azure.com/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourceGroups/resRg/providers/Microsoft.DigitalTwins/digitalTwinsInstances/myDigitalTwinsService?api-version=2023-01-31

Sample Response

{
  "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/digitalTwinsInstances/myDigitalTwinsService",
  "location": "westus2",
  "type": "Microsoft.DigitalTwins/digitalTwinsInstances",
  "name": "myDigitalTwinsService",
  "identity": {
    "type": "SystemAssigned",
    "principalId": "544215a9-21d8-4fb5-8094-8efbcc311dd0",
    "tenantId": "544215a9-21d8-4fb5-8094-8efbcc311dd0"
  },
  "systemData": {
    "createdBy": "user@example.com",
    "createdByType": "User",
    "createdAt": "2021-03-11T17:13:59.4037715Z",
    "lastModifiedBy": "user@example.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2021-03-11T17:14:02.5281409Z"
  },
  "properties": {
    "createdTime": "2019-11-19T12:55:05.229Z",
    "lastUpdatedTime": "2019-12-06T12:21:58.610Z",
    "provisioningState": "Failed",
    "hostName": "https://myDigitalTwinsService.api.wus2.ss.azuredigitaltwins-test.net"
  }
}
azure-asyncoperation: https://management.azure.com/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/providers/Microsoft.DigitalTwins/locations/westus2/operationStatuses/12345678-1234-1234-123456789012
location: https://management.azure.com/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/providers/Microsoft.DigitalTwins/locations/westus2/operationResults/12345678-1234-1234-123456789012
retry-after: 10
{
  "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/digitalTwinsInstances/myDigitalTwinsService",
  "location": "westus2",
  "type": "Microsoft.DigitalTwins/digitalTwinsInstances",
  "name": "myDigitalTwinsService",
  "identity": {
    "type": "SystemAssigned",
    "principalId": "544215a9-21d8-4fb5-8094-8efbcc311dd0",
    "tenantId": "544215a9-21d8-4fb5-8094-8efbcc311dd0"
  },
  "systemData": {
    "createdBy": "user@example.com",
    "createdByType": "User",
    "createdAt": "2021-03-11T17:13:59.4037715Z",
    "lastModifiedBy": "user@example.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2021-03-11T17:14:02.5281409Z"
  },
  "properties": {
    "createdTime": "2019-11-19T12:55:05.229Z",
    "lastUpdatedTime": "2019-12-06T12:21:58.610Z",
    "provisioningState": "Deleting",
    "hostName": "https://myDigitalTwinsService.api.wus2.ss.azuredigitaltwins-test.net"
  }
}

Definitioner

Name Description
ConnectionProperties

Egenskaperna för en privat slutpunktsanslutning.

ConnectionPropertiesProvisioningState

Etableringstillståndet.

createdByType

Den typ av identitet som skapade resursen.

DigitalTwinsDescription

Beskrivningen av DigitalTwins-tjänsten.

DigitalTwinsIdentity

Den hanterade identiteten för DigitalTwinsInstance.

DigitalTwinsIdentityType

Den typ av hanterad identitet som används av DigitalTwinsInstance.

ErrorDefinition

Feldefinition.

ErrorResponse

Felsvar.

PrivateEndpoint

Egenskapen privat slutpunkt för en privat slutpunktsanslutning.

PrivateEndpointConnection

Den privata slutpunktsanslutningen för en digital tvilling.

PrivateLinkServiceConnectionState

Anslutningstillståndet.

PrivateLinkServiceConnectionStatus

Status för en privat slutpunktsanslutning.

provisioningState

Etableringstillståndet.

publicNetworkAccess

Åtkomst till offentligt nätverk för DigitalTwinsInstance.

SystemData

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

UserAssignedIdentity

Information om den användartilldelade identiteten.

ConnectionProperties

Egenskaperna för en privat slutpunktsanslutning.

Name Typ Description
groupIds

string[]

Listan över grupp-ID:t för den privata slutpunktsanslutningen.

privateEndpoint

PrivateEndpoint

Den privata slutpunkten.

privateLinkServiceConnectionState

PrivateLinkServiceConnectionState

Anslutningstillståndet.

provisioningState

ConnectionPropertiesProvisioningState

Etableringstillståndet.

ConnectionPropertiesProvisioningState

Etableringstillståndet.

Name Typ Description
Approved

string

Disconnected

string

Pending

string

Rejected

string

createdByType

Den typ av identitet som skapade resursen.

Name Typ Description
Application

string

Key

string

ManagedIdentity

string

User

string

DigitalTwinsDescription

Beskrivningen av DigitalTwins-tjänsten.

Name Typ Description
id

string

Resursidentifieraren.

identity

DigitalTwinsIdentity

Den hanterade identiteten för DigitalTwinsInstance.

location

string

Resursplatsen.

name

string

Resursnamnet.

properties.createdTime

string

Tid då DigitalTwinsInstance skapades.

properties.hostName

string

Api-slutpunkt för att arbeta med DigitalTwinsInstance.

properties.lastUpdatedTime

string

Tid då DigitalTwinsInstance uppdaterades.

properties.privateEndpointConnections

PrivateEndpointConnection[]

De privata slutpunktsanslutningarna.

properties.provisioningState

provisioningState

Etableringstillståndet.

properties.publicNetworkAccess

publicNetworkAccess

Åtkomst till offentligt nätverk för DigitalTwinsInstance.

systemData

SystemData

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

tags

object

Resurstaggar.

type

string

Resurstypen.

DigitalTwinsIdentity

Den hanterade identiteten för DigitalTwinsInstance.

Name Typ Description
principalId

string

Objekt-ID för resursen för hanterad identitet. Detta skickas till RP från ARM via huvudet x-ms-identity-principal-id i PUT-begäran om resursen har en systemAssigned(implicit) identitet

tenantId

string

Klientorganisations-ID för resursen för hanterad identitet. Detta skickas till RP från ARM via huvudet x-ms-client-tenant-id i PUT-begäran om resursen har en systemAssigned(implicit) identitet

type

DigitalTwinsIdentityType

Den typ av hanterad identitet som används av DigitalTwinsInstance.

userAssignedIdentities

<string,  UserAssignedIdentity>

Listan över användaridentiteter som är associerade med resursen. Nyckelreferenserna för användaridentitetsordlistan är ARM-resurs-ID:er i formatet: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. .

DigitalTwinsIdentityType

Den typ av hanterad identitet som används av DigitalTwinsInstance.

Name Typ Description
None

string

SystemAssigned

string

SystemAssigned,UserAssigned

string

UserAssigned

string

ErrorDefinition

Feldefinition.

Name Typ Description
code

string

Tjänstspecifik felkod som fungerar som understatus för HTTP-felkoden.

details

ErrorDefinition[]

Intern felinformation.

message

string

Beskrivning av felet.

ErrorResponse

Felsvar.

Name Typ Description
error

ErrorDefinition

Felbeskrivning

PrivateEndpoint

Egenskapen privat slutpunkt för en privat slutpunktsanslutning.

Name Typ Description
id

string

Resursidentifieraren.

PrivateEndpointConnection

Den privata slutpunktsanslutningen för en digital tvilling.

Name Typ Description
id

string

Resursidentifieraren.

name

string

Resursnamnet.

properties

ConnectionProperties

Anslutningsegenskaperna.

systemData

SystemData

Metadata som rör skapande och senaste ändring av den privata slutpunktsanslutningen.

type

string

Resurstypen.

PrivateLinkServiceConnectionState

Anslutningstillståndet.

Name Typ Description
actionsRequired

string

Åtgärder som krävs för en privat slutpunktsanslutning.

description

string

Beskrivning av det aktuella tillståndet för en privat slutpunktsanslutning.

status

PrivateLinkServiceConnectionStatus

Status för en privat slutpunktsanslutning.

PrivateLinkServiceConnectionStatus

Status för en privat slutpunktsanslutning.

Name Typ Description
Approved

string

Disconnected

string

Pending

string

Rejected

string

provisioningState

Etableringstillståndet.

Name Typ Description
Canceled

string

Deleted

string

Deleting

string

Failed

string

Moving

string

Provisioning

string

Restoring

string

Succeeded

string

Suspending

string

Updating

string

Warning

string

publicNetworkAccess

Åtkomst till offentligt nätverk för DigitalTwinsInstance.

Name Typ Description
Disabled

string

Enabled

string

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.

UserAssignedIdentity

Information om den användartilldelade identiteten.

Name Typ Description
clientId

string

Klient-ID för den användartilldelade identitetsresursen.

principalId

string

Objekt-ID för den användartilldelade identitetsresursen.