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 |
---|---|---|---|---|
resource
|
path | True |
string |
Nazwa grupy zasobów. W nazwie jest uwzględniana wielkość liter. |
sim
|
path | True |
string |
Nazwa grupy SIM. Wzorzec wyrażenia regularnego: |
sim
|
path | True |
string |
Nazwa karty SIM. Wzorzec wyrażenia regularnego: |
subscription
|
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 |
Zasady SIM używane przez tę kartę SIM. Zasady SIM muszą znajdować się w tej samej lokalizacji co karta SIM. |
||
properties.staticIpConfiguration |
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 |
Aktualizacja powiodła się. Operacja zwraca wynikowy zasób SIM. |
|
201 Created |
Twórca pomyślne. Operacja zwraca wynikowy zasób SIM. |
|
Other Status Codes |
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 |
---|---|
Attached |
Odwołanie do dołączonego zasobu sieciowego danych. |
created |
Typ tożsamości, która utworzyła zasób. |
Error |
Dodatkowe informacje o błędzie zarządzania zasobami. |
Error |
Szczegóły błędu. |
Error |
Odpowiedź na błąd |
Provisioning |
Bieżący stan aprowizacji. |
Sim |
Zasób SIM. |
Sim |
Odwołanie do zasobu zasad SIM. |
Sim |
Stan zasobu SIM. |
Sim |
Statyczna konfiguracja adresu IP dla karty SIM, ograniczona do określonej dołączonej sieci danych i wycinka. |
Slice |
Odwołanie do zasobu wycinka. |
Static |
Konfiguracja statycznego adresu IP dla karty SIM do użycia w zdefiniowanym zakresie sieci. |
system |
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 |
Dodatkowe informacje o błędzie. |
|
code |
string |
Kod błędu. |
details |
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 |
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 |
Stan aprowizacji zasobu SIM. |
|
properties.simPolicy |
Zasady SIM używane przez tę kartę SIM. Zasady SIM muszą znajdować się w tej samej lokalizacji co karta SIM. |
|
properties.simState |
Stan zasobu SIM. |
|
properties.siteProvisioningState |
object |
Słownik witryn do stanu aprowizacji tej karty SIM w tej witrynie. |
properties.staticIpConfiguration |
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 |
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 |
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 |
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 |
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 |
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 |
Typ tożsamości, która ostatnio zmodyfikowała zasób. |