Udostępnij za pośrednictwem


Sims - Create Or Update

Tworzy lub aktualizuje kartę SIM.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MobileNetwork/simGroups/{simGroupName}/sims/{simName}?api-version=2024-04-01

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
resourceGroupName
path True

string

Nazwa grupy zasobów. W nazwie jest uwzględniana wielkość liter.

simGroupName
path True

string

Nazwa grupy SIM.

Wzorzec wyrażenia regularnego: ^[a-zA-Z0-9][a-zA-Z0-9_-]*$

simName
path True

string

Nazwa karty SIM.

Wzorzec wyrażenia regularnego: ^[a-zA-Z0-9][a-zA-Z0-9_-]*$

subscriptionId
path True

string

uuid

Identyfikator subskrypcji docelowej. Wartość musi być identyfikatorem UUID.

api-version
query True

string

Wersja interfejsu API do użycia dla tej operacji.

Treść żądania

Nazwa Wymagane Typ Opis
properties.internationalMobileSubscriberIdentity True

string

Międzynarodowa tożsamość subskrybenta urządzeń przenośnych (IMSI) dla karty SIM.

properties.authenticationKey

string

Wartość Ki dla karty SIM.

properties.deviceType

string

Opcjonalne pole tekstowe o dowolnej formie, które może służyć do rejestrowania typu urządzenia, z którą jest skojarzona ta karta SIM, na przykład "Kamera wideo". Azure Portal umożliwia grupowanie i filtrowanie siM na podstawie tej wartości.

properties.integratedCircuitCardIdentifier

string

Identyfikator karty obwodu zintegrowanego (ICCID) dla karty SIM.

properties.operatorKeyCode

string

Wartość Opc dla karty SIM.

properties.simPolicy

SimPolicyResourceId

Zasady SIM używane przez tę kartę SIM. Zasady SIM muszą znajdować się w tej samej lokalizacji co karta SIM.

properties.staticIpConfiguration

SimStaticIpProperties[]

Lista statycznych adresów IP przypisanych do tej karty SIM. Każdy adres jest przypisywany w zdefiniowanym zakresie sieci, składającym się z {dołączonej sieci danych, wycinek}.

Odpowiedzi

Nazwa Typ Opis
200 OK

Sim

Aktualizacja powiodła się. Operacja zwraca wynikowy zasób SIM.

201 Created

Sim

Twórca pomyślne. Operacja zwraca wynikowy zasób SIM.

Other Status Codes

ErrorResponse

Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się.

Zabezpieczenia

azure_auth

Przepływ OAuth2 usługi Azure Active Directory.

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa Opis
user_impersonation personifikacja konta użytkownika

Przykłady

Create SIM

Przykładowe żądanie

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"
        }
      }
    ]
  }
}

Przykładowa odpowiedź

{
  "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"
        }
      }
    ]
  }
}

Definicje

Nazwa Opis
AttachedDataNetworkResourceId

Odwołanie do dołączonego zasobu sieciowego danych.

createdByType

Typ tożsamości, która utworzyła zasób.

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

ErrorDetail

Szczegóły błędu.

ErrorResponse

Odpowiedź na błąd

ProvisioningState

Bieżący stan aprowizacji.

Sim

Zasób SIM.

SimPolicyResourceId

Odwołanie do zasobu zasad SIM.

SimState

Stan zasobu SIM.

SimStaticIpProperties

Statyczna konfiguracja adresu IP dla karty SIM, ograniczona do określonej dołączonej sieci danych i wycinka.

SliceResourceId

Odwołanie do zasobu wycinka.

StaticIp

Konfiguracja statycznego adresu IP dla karty SIM do użycia w zdefiniowanym zakresie sieci.

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

AttachedDataNetworkResourceId

Odwołanie do dołączonego zasobu sieciowego danych.

Nazwa Typ Opis
id

string

Identyfikator zasobu sieciowego dołączonych danych.

createdByType

Typ tożsamości, która utworzyła zasób.

Nazwa Typ Opis
Application

string

Key

string

ManagedIdentity

string

User

string

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa Typ Opis
info

object

Dodatkowe informacje.

type

string

Dodatkowy typ informacji.

ErrorDetail

Szczegóły błędu.

Nazwa Typ Opis
additionalInfo

ErrorAdditionalInfo[]

Dodatkowe informacje o błędzie.

code

string

Kod błędu.

details

ErrorDetail[]

Szczegóły błędu.

message

string

Komunikat o błędzie.

target

string

Element docelowy błędu.

ErrorResponse

Odpowiedź na błąd

Nazwa Typ Opis
error

ErrorDetail

Obiekt error.

ProvisioningState

Bieżący stan aprowizacji.

Nazwa Typ Opis
Accepted

string

Canceled

string

Deleted

string

Deleting

string

Failed

string

Succeeded

string

Unknown

string

Sim

Zasób SIM.

Nazwa Typ Opis
id

string

W pełni kwalifikowany identyfikator zasobu dla zasobu. Np. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

name

string

Nazwa zasobu

properties.authenticationKey

string

Wartość Ki dla karty SIM.

properties.deviceType

string

Opcjonalne pole tekstowe o dowolnej formie, które może służyć do rejestrowania typu urządzenia, z którą jest skojarzona ta karta SIM, na przykład "Kamera wideo". Azure Portal umożliwia grupowanie i filtrowanie siM na podstawie tej wartości.

properties.integratedCircuitCardIdentifier

string

Identyfikator karty obwodu zintegrowanego (ICCID) dla karty SIM.

properties.internationalMobileSubscriberIdentity

string

Międzynarodowa tożsamość subskrybenta urządzeń przenośnych (IMSI) dla karty SIM.

properties.operatorKeyCode

string

Wartość Opc dla karty SIM.

properties.provisioningState

ProvisioningState

Stan aprowizacji zasobu SIM.

properties.simPolicy

SimPolicyResourceId

Zasady SIM używane przez tę kartę SIM. Zasady SIM muszą znajdować się w tej samej lokalizacji co karta SIM.

properties.simState

SimState

Stan zasobu SIM.

properties.siteProvisioningState

object

Słownik witryn do stanu aprowizacji tej karty SIM w tej witrynie.

properties.staticIpConfiguration

SimStaticIpProperties[]

Lista statycznych adresów IP przypisanych do tej karty SIM. Każdy adres jest przypisywany w zdefiniowanym zakresie sieci, składającym się z {dołączonej sieci danych, wycinek}.

properties.vendorKeyFingerprint

string

Odcisk palca klucza publicznego dostawcy karty SIM, który dostarczył tę kartę SIM, jeśli istnieje.

properties.vendorName

string

Nazwa dostawcy SIM, który dostarczył tę kartę SIM, jeśli istnieje.

systemData

systemData

Metadane usługi Azure Resource Manager zawierające informacje createdBy i modifiedBy.

type

string

Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts"

SimPolicyResourceId

Odwołanie do zasobu zasad SIM.

Nazwa Typ Opis
id

string

Identyfikator zasobu zasad SIM.

SimState

Stan zasobu SIM.

Nazwa Typ Opis
Disabled

string

Karta SIM jest wyłączona, ponieważ nie wszystkie konfiguracje wymagane do włączenia są obecne.

Enabled

string

Karta SIM jest włączona.

Invalid

string

Nie można włączyć karty SIM, ponieważ część skojarzonej konfiguracji jest nieprawidłowa.

SimStaticIpProperties

Statyczna konfiguracja adresu IP dla karty SIM, ograniczona do określonej dołączonej sieci danych i wycinka.

Nazwa Typ Opis
attachedDataNetwork

AttachedDataNetworkResourceId

Dołączona sieć danych, w której będzie używany statyczny adres IP. Kombinacja dołączonej sieci danych i wycinka definiuje zakres sieciowy adresu IP. Dołączona sieć danych musi znajdować się w tej samej lokalizacji co karta SIM.

slice

SliceResourceId

Wycinek sieci, na którym będzie używany statyczny adres IP. Kombinacja dołączonej sieci danych i wycinka definiuje zakres sieciowy adresu IP. Wycinek musi znajdować się w tej samej lokalizacji co karta SIM.

staticIp

StaticIp

Konfiguracja statycznego adresu IP dla karty SIM do użycia w zdefiniowanym zakresie sieci.

SliceResourceId

Odwołanie do zasobu wycinka.

Nazwa Typ Opis
id

string

Identyfikator zasobu fragmentatora.

StaticIp

Konfiguracja statycznego adresu IP dla karty SIM do użycia w zdefiniowanym zakresie sieci.

Nazwa Typ Opis
ipv4Address

string

Adres IPv4 przypisany do karty SIM w tym zakresie sieci. Ten adres musi znajdować się w elemecie userEquipmentStaticAddressPoolPrefix zdefiniowanym w dołączonej sieci danych.

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Nazwa Typ Opis
createdAt

string

Sygnatura czasowa tworzenia zasobów (UTC).

createdBy

string

Tożsamość, która utworzyła zasób.

createdByType

createdByType

Typ tożsamości, która utworzyła zasób.

lastModifiedAt

string

Sygnatura czasowa ostatniej modyfikacji zasobu (UTC)

lastModifiedBy

string

Tożsamość, która ostatnio zmodyfikowała zasób.

lastModifiedByType

createdByType

Typ tożsamości, która ostatnio zmodyfikowała zasób.