Sims - Bulk Upload
Massenupload von SIMs in eine SIM-Gruppe.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MobileNetwork/simGroups/{simGroupName}/uploadSims?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: |
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 |
---|---|---|---|
sims | True |
Eine Liste der hochzuladenden SIMs. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
Asynchroner Vorgang abgeschlossen. |
|
202 Accepted |
Akzeptiert: Gibt einen Vorgangs-URI zurück, der abgefragt werden kann, um den aktuellen Status des Vorgangs zu ermitteln. |
|
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
Bulk upload SIMs in a SIM group
Beispielanforderung
POST https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/simGroups/testSimGroup/uploadSims?api-version=2024-04-01
{
"sims": [
{
"name": "testSim",
"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"
}
}
]
}
},
{
"name": "testSim2",
"properties": {
"integratedCircuitCardIdentifier": "8900000000000000001",
"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.2"
}
}
]
}
}
]
}
Beispiel für eine Antwort
{
"id": "/providers/Microsoft.MobileNetwork/locations/testLocation/operationStatuses/testOperation",
"name": "testOperation",
"status": "Succeeded",
"startTime": "2021-08-19T03:36:07.000Z",
"endTime": "2021-08-19T03:38:07.000Z"
}
Azure-AsyncOperation: https://management.azure.com/providers/Microsoft.MobileNetwork/locations/testLocation/operationStatuses/testOperation?api-version=2024-04-01
Definitionen
Name | Beschreibung |
---|---|
Async |
Die aktuelle status eines asynchronen Vorgangs. |
Attached |
Verweis auf eine angefügte Datennetzwerkressource. |
Error |
Zusätzliche Informationen zum Ressourcenverwaltungsfehler. |
Error |
Die Fehlerdetails. |
Error |
Fehlerantwort |
Provisioning |
Der aktuelle Bereitstellungsstatus. |
Sim |
SIM-Name und -Eigenschaften. |
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. |
Sim |
Die hochzuladenden SIMs. |
Slice |
Verweis auf eine Sliceressource. |
Static |
Die statische IP-Konfiguration für die SIM-Karte, die im definierten Netzwerkbereich verwendet werden soll. |
AsyncOperationStatus
Die aktuelle status eines asynchronen Vorgangs.
Name | Typ | Beschreibung |
---|---|---|
endTime |
string |
Die Endzeit des Vorgangs. |
error |
Falls vorhanden, details des Vorgangsfehlers. |
|
id |
string |
Vollqualifizierte ID für den asynchronen Vorgang. |
name |
string |
Name des asynchronen Vorgangs. |
percentComplete |
number |
Prozentsatz des abgeschlossenen Vorgangs. |
properties |
object |
Eigenschaften, die vom Ressourcenanbieter bei einem erfolgreichen Vorgang zurückgegeben werden |
resourceId |
string |
Vollqualifizierte ID für die Ressource, auf die sich dieser asynchrone Vorgang status. |
startTime |
string |
Die Startzeit des Vorgangs. |
status |
string |
Der Vorgangsstatus. |
AttachedDataNetworkResourceId
Verweis auf eine angefügte Datennetzwerkressource.
Name | Typ | Beschreibung |
---|---|---|
id |
string |
Id der angefügten Datennetzwerkressource. |
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 |
SimNameAndProperties
SIM-Name und -Eigenschaften.
Name | Typ | Beschreibung |
---|---|---|
name |
string |
Der Name der 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.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. |
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. |
SimUploadList
Die hochzuladenden SIMs.
Name | Typ | Beschreibung |
---|---|---|
sims |
Eine Liste der hochzuladenden SIMs. |
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. |