Sims - Create Or Update
Erstellt oder aktualisiert eine SIM-Karte.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MobileNetwork/simGroups/{simGroupName}/sims/{simName}?api-version=2024-04-01
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
resource
|
path | True |
string |
Der Name der Ressourcengruppe. Für den Namen wird die Groß-/Kleinschreibung nicht beachtet. |
sim
|
path | True |
string |
Der Name der SIM-Gruppe. RegEx-Muster: |
sim
|
path | True |
string |
Der Name der SIM. RegEx-Muster: |
subscription
|
path | True |
string uuid |
Hierbei handelt es sich um die ID des Zielabonnements. Der Wert muss eine UUID sein. |
api-version
|
query | True |
string |
Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version. |
Anforderungstext
Name | Erforderlich | Typ | Beschreibung |
---|---|---|---|
properties.internationalMobileSubscriberIdentity | True |
string |
Die internationale mobile Abonnentenidentität (IMSI) für die SIM. |
properties.authenticationKey |
string |
Der Ki-Wert für die SIM. |
|
properties.deviceType |
string |
Ein optionales Freiform-Textfeld, das zum Aufzeichnen des Gerätetyps verwendet werden kann, dem diese SIM zugeordnet ist, z. B. "Videokamera". Die Azure-Portal ermöglicht das Gruppieren und Filtern von SIMs basierend auf diesem Wert. |
|
properties.integratedCircuitCardIdentifier |
string |
Die integrierte Schaltung Karte ID (ICCID) für die SIM. |
|
properties.operatorKeyCode |
string |
Der Opc-Wert für die SIM. |
|
properties.simPolicy |
Die sim-Richtlinie, die von dieser SIM-Karte verwendet wird. Die SIM-Richtlinie muss sich am gleichen Ort wie die SIM-Karte befinden. |
||
properties.staticIpConfiguration |
Eine Liste der statischen IP-Adressen, die dieser SIM zugewiesen sind. Jede Adresse wird in einem definierten Netzwerkbereich zugewiesen, der aus {angefügtem Datennetzwerk, Slice} besteht. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
Aktualisierung erfolgreich. Der Vorgang gibt die resultierende SIM-Ressource zurück. |
|
201 Created |
Create erfolgreich. Der Vorgang gibt die resultierende SIM-Ressource zurück. |
|
Other Status Codes |
Fehlerantwort mit Beschreibung des Grunds für den Fehler. |
Sicherheit
azure_auth
Azure Active Directory OAuth2-Flow.
Typ:
oauth2
Ablauf:
implicit
Autorisierungs-URL:
https://login.microsoftonline.com/common/oauth2/authorize
Bereiche
Name | Beschreibung |
---|---|
user_impersonation | Identitätswechsel Ihres Benutzerkontos |
Beispiele
Create SIM
Beispielanforderung
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/simGroups/testSimGroup/sims/testSim?api-version=2024-04-01
{
"properties": {
"integratedCircuitCardIdentifier": "8900000000000000000",
"internationalMobileSubscriberIdentity": "00000",
"authenticationKey": "00000000000000000000000000000000",
"operatorKeyCode": "00000000000000000000000000000000",
"deviceType": "Video camera",
"simPolicy": {
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/simPolicies/MySimPolicy"
},
"staticIpConfiguration": [
{
"attachedDataNetwork": {
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/packetCoreControlPlanes/TestPacketCoreCP/packetCoreDataPlanes/TestPacketCoreDP/attachedDataNetworks/TestAttachedDataNetwork"
},
"slice": {
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/slices/testSlice"
},
"staticIp": {
"ipv4Address": "2.4.0.1"
}
}
]
}
}
Beispiel für eine Antwort
{
"name": "testSim",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/simGroups/testSimGroup/sims/testSim",
"type": "Microsoft.MobileNetwork/simGroups/sims",
"systemData": {
"createdBy": "user1",
"createdByType": "User",
"createdAt": "2020-01-01T17:18:19.1234567Z",
"lastModifiedBy": "user2",
"lastModifiedByType": "User",
"lastModifiedAt": "2020-01-02T17:18:19.1234567Z"
},
"properties": {
"provisioningState": "Succeeded",
"simState": "Enabled",
"siteProvisioningState": {
"/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/sites/testSite": "Provisioned",
"/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/sites/testSite2": "Provisioned"
},
"integratedCircuitCardIdentifier": "8900000000000000000",
"internationalMobileSubscriberIdentity": "00000",
"deviceType": "Video camera",
"simPolicy": {
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/simPolicies/MySimPolicy"
},
"staticIpConfiguration": [
{
"attachedDataNetwork": {
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/packetCoreControlPlanes/TestPacketCoreCP/packetCoreDataPlanes/TestPacketCoreDP/attachedDataNetworks/TestAttachedDataNetwork"
},
"slice": {
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/slices/testSlice"
},
"staticIp": {
"ipv4Address": "2.4.0.1"
}
}
]
}
}
Azure-AsyncOperation: https://management.azure.com/providers/Microsoft.MobileNetwork/locations/testLocation/operationStatuses/testOperation?api-version=2024-04-01
{
"name": "testSim",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/simGroups/testSimGroup/sims/testSim",
"type": "Microsoft.MobileNetwork/simGroups/sims",
"systemData": {
"createdBy": "user1",
"createdByType": "User",
"createdAt": "2020-01-01T17:18:19.1234567Z",
"lastModifiedBy": "user2",
"lastModifiedByType": "User",
"lastModifiedAt": "2020-01-02T17:18:19.1234567Z"
},
"properties": {
"provisioningState": "Created",
"simState": "Enabled",
"siteProvisioningState": {
"/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/sites/testSite": "Adding",
"/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/sites/testSite2": "Adding"
},
"integratedCircuitCardIdentifier": "8900000000000000000",
"internationalMobileSubscriberIdentity": "00000",
"deviceType": "Video camera",
"simPolicy": {
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/simPolicies/MySimPolicy"
},
"staticIpConfiguration": [
{
"attachedDataNetwork": {
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/packetCoreControlPlanes/TestPacketCoreCP/packetCoreDataPlanes/TestPacketCoreDP/attachedDataNetworks/TestAttachedDataNetwork"
},
"slice": {
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/slices/testSlice"
},
"staticIp": {
"ipv4Address": "2.4.0.1"
}
}
]
}
}
Definitionen
Name | Beschreibung |
---|---|
Attached |
Verweis auf eine angefügte Datennetzwerkressource. |
created |
Der Identitätstyp, der die Ressource erstellt hat. |
Error |
Zusätzliche Informationen zum Ressourcenverwaltungsfehler. |
Error |
Die Fehlerdetails. |
Error |
Fehlerantwort |
Provisioning |
Der aktuelle Bereitstellungsstatus. |
Sim |
SIM-Ressource. |
Sim |
Verweis auf eine SIM-Richtlinienressource. |
Sim |
Der Zustand der SIM-Ressource. |
Sim |
Statische IP-Konfiguration für eine SIM-Karte, die auf ein bestimmtes angefügtes Datennetzwerk und slice ausgerichtet ist. |
Slice |
Verweis auf eine Sliceressource. |
Static |
Die statische IP-Konfiguration für die SIM-Karte, die im definierten Netzwerkbereich verwendet werden soll. |
system |
Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen. |
AttachedDataNetworkResourceId
Verweis auf eine angefügte Datennetzwerkressource.
Name | Typ | Beschreibung |
---|---|---|
id |
string |
Id der angefügten Datennetzwerkressource. |
createdByType
Der Identitätstyp, der die Ressource erstellt hat.
Name | Typ | Beschreibung |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
ErrorAdditionalInfo
Zusätzliche Informationen zum Ressourcenverwaltungsfehler.
Name | Typ | Beschreibung |
---|---|---|
info |
object |
Zusätzliche Informationen. |
type |
string |
Typ der zusätzlichen Informationen. |
ErrorDetail
Die Fehlerdetails.
Name | Typ | Beschreibung |
---|---|---|
additionalInfo |
Die zusätzlichen Fehlerinformationen. |
|
code |
string |
Der Fehlercode. |
details |
Die Fehlerdetails. |
|
message |
string |
Die Fehlermeldung. |
target |
string |
Das Fehlerziel. |
ErrorResponse
Fehlerantwort
Name | Typ | Beschreibung |
---|---|---|
error |
Das Fehlerobjekt. |
ProvisioningState
Der aktuelle Bereitstellungsstatus.
Name | Typ | Beschreibung |
---|---|---|
Accepted |
string |
|
Canceled |
string |
|
Deleted |
string |
|
Deleting |
string |
|
Failed |
string |
|
Succeeded |
string |
|
Unknown |
string |
Sim
SIM-Ressource.
Name | Typ | Beschreibung |
---|---|---|
id |
string |
Vollqualifizierte Ressourcen-ID für die Ressource. Beispiel: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
name |
string |
Der Name der Ressource |
properties.authenticationKey |
string |
Der Ki-Wert für die SIM. |
properties.deviceType |
string |
Ein optionales Freiform-Textfeld, das zum Aufzeichnen des Gerätetyps verwendet werden kann, dem diese SIM zugeordnet ist, z. B. "Videokamera". Die Azure-Portal ermöglicht das Gruppieren und Filtern von SIMs basierend auf diesem Wert. |
properties.integratedCircuitCardIdentifier |
string |
Die integrierte Schaltung Karte ID (ICCID) für die SIM. |
properties.internationalMobileSubscriberIdentity |
string |
Die internationale mobile Abonnentenidentität (IMSI) für die SIM. |
properties.operatorKeyCode |
string |
Der Opc-Wert für die SIM. |
properties.provisioningState |
Der Bereitstellungsstatus der SIM-Ressource. |
|
properties.simPolicy |
Die sim-Richtlinie, die von dieser SIM-Karte verwendet wird. Die SIM-Richtlinie muss sich am gleichen Ort wie die SIM-Karte befinden. |
|
properties.simState |
Der Zustand der SIM-Ressource. |
|
properties.siteProvisioningState |
object |
Ein Wörterbuch von Websites zum Bereitstellungsstatus dieser SIM-Karte auf dieser Website. |
properties.staticIpConfiguration |
Eine Liste der statischen IP-Adressen, die dieser SIM zugewiesen sind. Jede Adresse wird in einem definierten Netzwerkbereich zugewiesen, der aus {angefügtem Datennetzwerk, Slice} besteht. |
|
properties.vendorKeyFingerprint |
string |
Die öffentliche Schlüsselfingerabdruck des SIM-Anbieters, der diese SIM bereitgestellt hat, falls vorhanden. |
properties.vendorName |
string |
Der Name des SIM-Anbieters, der diese SIM bereitgestellt hat, falls vorhanden. |
systemData |
Azure Resource Manager-Metadaten mit createdBy- und modifiedBy-Informationen. |
|
type |
string |
Der Typ der Ressource. Z.B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts" |
SimPolicyResourceId
Verweis auf eine SIM-Richtlinienressource.
Name | Typ | Beschreibung |
---|---|---|
id |
string |
RESSOURCEN-ID der SIM-Richtlinie. |
SimState
Der Zustand der SIM-Ressource.
Name | Typ | Beschreibung |
---|---|---|
Disabled |
string |
Die SIM-Karte ist deaktiviert, da nicht alle für die Aktivierung erforderlichen Konfigurationen vorhanden sind. |
Enabled |
string |
Die SIM-Karte ist aktiviert. |
Invalid |
string |
Die SIM-Karte kann nicht aktiviert werden, weil einige der zugeordneten Konfigurationen ungültig sind. |
SimStaticIpProperties
Statische IP-Konfiguration für eine SIM-Karte, die auf ein bestimmtes angefügtes Datennetzwerk und slice ausgerichtet ist.
Name | Typ | Beschreibung |
---|---|---|
attachedDataNetwork |
Das angefügte Datennetzwerk, in dem die statische IP-Adresse verwendet wird. Die Kombination aus angefügtem Datennetzwerk und Slice definiert den Netzwerkbereich der IP-Adresse. Das angefügte Datennetzwerk muss sich am selben Ort wie die SIM-Karte befinden. |
|
slice |
Der Netzwerkslice, in dem die statische IP-Adresse verwendet wird. Die Kombination aus angefügtem Datennetzwerk und Slice definiert den Netzwerkbereich der IP-Adresse. Der Slice muss sich am gleichen Speicherort wie die SIM-Karte befinden. |
|
staticIp |
Die statische IP-Konfiguration für die SIM-Karte, die im definierten Netzwerkbereich verwendet werden soll. |
SliceResourceId
Verweis auf eine Sliceressource.
Name | Typ | Beschreibung |
---|---|---|
id |
string |
Slice-Ressourcen-ID. |
StaticIp
Die statische IP-Konfiguration für die SIM-Karte, die im definierten Netzwerkbereich verwendet werden soll.
Name | Typ | Beschreibung |
---|---|---|
ipv4Address |
string |
Die IPv4-Adresse, die der SIM in diesem Netzwerkbereich zugewiesen ist. Diese Adresse muss sich im im angefügten Datennetzwerk definierten userEquipmentStaticAddressPoolPrefix befinden. |
systemData
Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.
Name | Typ | Beschreibung |
---|---|---|
createdAt |
string |
Der Zeitstempel der Ressourcenerstellung (UTC). |
createdBy |
string |
Die Identität, die die Ressource erstellt hat. |
createdByType |
Der Identitätstyp, der die Ressource erstellt hat. |
|
lastModifiedAt |
string |
Der Zeitstempel der letzten Änderung der Ressource (UTC) |
lastModifiedBy |
string |
Die Identität, die die Ressource zuletzt geändert hat. |
lastModifiedByType |
Der Identitätstyp, der die Ressource zuletzt geändert hat. |