Freigeben über


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
resourceGroupName
path True

string

Der Name der Ressourcengruppe. Für den Namen wird die Groß-/Kleinschreibung nicht beachtet.

simGroupName
path True

string

Der Name der SIM-Gruppe.

RegEx-Muster: ^[a-zA-Z0-9][a-zA-Z0-9_-]*$

subscriptionId
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

SimNameAndProperties[]

Eine Liste der hochzuladenden SIMs.

Antworten

Name Typ Beschreibung
200 OK

AsyncOperationStatus

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

ErrorResponse

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
AsyncOperationStatus

Die aktuelle status eines asynchronen Vorgangs.

AttachedDataNetworkResourceId

Verweis auf eine angefügte Datennetzwerkressource.

ErrorAdditionalInfo

Zusätzliche Informationen zum Ressourcenverwaltungsfehler.

ErrorDetail

Die Fehlerdetails.

ErrorResponse

Fehlerantwort

ProvisioningState

Der aktuelle Bereitstellungsstatus.

SimNameAndProperties

SIM-Name und -Eigenschaften.

SimPolicyResourceId

Verweis auf eine SIM-Richtlinienressource.

SimState

Der Zustand der SIM-Ressource.

SimStaticIpProperties

Statische IP-Konfiguration für eine SIM-Karte, die auf ein bestimmtes angefügtes Datennetzwerk und slice ausgerichtet ist.

SimUploadList

Die hochzuladenden SIMs.

SliceResourceId

Verweis auf eine Sliceressource.

StaticIp

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

ErrorDetail

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

ErrorAdditionalInfo[]

Die zusätzlichen Fehlerinformationen.

code

string

Der Fehlercode.

details

ErrorDetail[]

Die Fehlerdetails.

message

string

Die Fehlermeldung.

target

string

Das Fehlerziel.

ErrorResponse

Fehlerantwort

Name Typ Beschreibung
error

ErrorDetail

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

ProvisioningState

Der Bereitstellungsstatus der SIM-Ressource.

properties.simPolicy

SimPolicyResourceId

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

SimState

Der Zustand der SIM-Ressource.

properties.siteProvisioningState

object

Ein Wörterbuch von Websites zum Bereitstellungsstatus dieser SIM-Karte auf dieser Website.

properties.staticIpConfiguration

SimStaticIpProperties[]

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

AttachedDataNetworkResourceId

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

SliceResourceId

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

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

SimNameAndProperties[]

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.