Поделиться через

Sims - Create Or Update

  • Ссылка
Служба:
Mobile Network
Версия API:
2024-04-01

Создает или обновляет SIM-карту.

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

Параметры URI

Имя В Обязательно Тип Описание
resourceGroupName
 path True

string

Имя группы ресурсов. Регистр букв в имени не учитывается.
simGroupName
 path True

string

Имя группы SIM-карт.

Шаблон регулярного выражения: ^[a-zA-Z0-9][a-zA-Z0-9_-]*$
simName
 path True

string

Имя SIM-карты.

Шаблон регулярного выражения: ^[a-zA-Z0-9][a-zA-Z0-9_-]*$
subscriptionId
 path True

string

uuid

Идентификатор целевой подписки. Значение должно быть UUID.
api-version
 query True

string

Версия API, используемая для данной операции.

Текст запроса

Имя Обязательно Тип Описание
properties.internationalMobileSubscriberIdentity True

string

Идентификатор международного мобильного абонента (IMSI) для SIM-карты.
properties.authenticationKey

string

Значение Ki для SIM-карты.
properties.deviceType

string

Необязательное текстовое поле в свободной форме, которое можно использовать для записи типа устройства, с которым связана эта SIM-карта, например "Видеокамера". Портал Azure позволяет группировать и фильтровать SIM-файлы на основе этого значения.
properties.integratedCircuitCardIdentifier

string

Идентификатор карта интегральной схемы (ICCID) для SIM-карты.
properties.operatorKeyCode

string

Значение Opc для SIM-карты.
properties.simPolicy

SimPolicyResourceId

Политика SIM-карты, используемая этой SIM-картой. Политика SIM-карты должна находиться в том же расположении, что и SIM-карта.
properties.staticIpConfiguration

SimStaticIpProperties[]

Список статических IP-адресов, назначенных этой SIM-карте. Каждый адрес назначается в определенной сетевой область, состоящей из {подключенной сети данных, среза}.

Ответы

Имя Тип Описание
200 OK

Sim

Обновление выполнено успешно. Операция возвращает результирующий ресурс SIM-карты.
201 Created

Sim

Create успешно. Операция возвращает результирующий ресурс SIM-карты.
Other Status Codes

ErrorResponse

Ответ об ошибке, описывающий причину сбоя операции.

Безопасность

azure_auth

Поток OAuth2 в Azure Active Directory.

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя Описание
user_impersonation олицетворения учетной записи пользователя

Примеры

Create SIM

Образец запроса

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

Пример ответа

Код состояния:
200 
{
  "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"
        }
      }
    ]
  }
}
Код состояния:
201 
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"
        }
      }
    ]
  }
}

Определения

Имя Описание
AttachedDataNetworkResourceId

Ссылка на подключенный сетевой ресурс данных.
createdByType

Тип удостоверения, создавшего ресурс.
ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.
ErrorDetail

Сведения об ошибке.
ErrorResponse

Сообщение об ошибке
ProvisioningState

Текущее состояние подготовки.
Sim

Ресурс SIM-карты.
SimPolicyResourceId

Ссылка на ресурс политики SIM-карты.
SimState

Состояние ресурса SIM-карты.
SimStaticIpProperties

Статическая IP-конфигурация для SIM-карты, ограниченная определенной подключенной сетью данных и срезом.
SliceResourceId

Ссылка на ресурс среза.
StaticIp

Статическая IP-конфигурация для SIM-карты, используемая в определенной сетевой область.
systemData

Метаданные, относящиеся к созданию и последнему изменению ресурса.

AttachedDataNetworkResourceId

Ссылка на подключенный сетевой ресурс данных.

Имя Тип Описание
id

string

Идентификатор ресурса подключенной сети данных.

createdByType

Тип удостоверения, создавшего ресурс.

Имя Тип Описание
Application

string

Key

string

ManagedIdentity

string

User

string

ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

Имя Тип Описание
info

object

Дополнительные сведения.
type

string

Тип дополнительных сведений.

ErrorDetail

Сведения об ошибке.

Имя Тип Описание
additionalInfo

ErrorAdditionalInfo[]

Дополнительные сведения об ошибке.
code

string

Код ошибки.
details

ErrorDetail[]

Сведения об ошибке.
message

string

Сообщение об ошибке.
target

string

Целевой объект ошибки.

ErrorResponse

Сообщение об ошибке

Имя Тип Описание
error

ErrorDetail

Объект error.

ProvisioningState

Текущее состояние подготовки.

Имя Тип Описание
Accepted

string

Canceled

string

Deleted

string

Deleting

string

Failed

string

Succeeded

string

Unknown

string

Sim

Ресурс SIM-карты.

Имя Тип Описание
id

string

Полный идентификатор ресурса. Например, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name

string

Имя ресурса.
properties.authenticationKey

string

Значение Ki для SIM-карты.
properties.deviceType

string

Необязательное текстовое поле в свободной форме, которое можно использовать для записи типа устройства, с которым связана эта SIM-карта, например "Видеокамера". Портал Azure позволяет группировать и фильтровать SIM-файлы на основе этого значения.
properties.integratedCircuitCardIdentifier

string

Идентификатор карта интегральной схемы (ICCID) для SIM-карты.
properties.internationalMobileSubscriberIdentity

string

Идентификатор международного мобильного абонента (IMSI) для SIM-карты.
properties.operatorKeyCode

string

Значение Opc для SIM-карты.
properties.provisioningState

ProvisioningState

Состояние подготовки ресурса SIM-карты.
properties.simPolicy

SimPolicyResourceId

Политика SIM-карты, используемая этой SIM-картой. Политика SIM-карты должна находиться в том же расположении, что и SIM-карта.
properties.simState

SimState

Состояние ресурса SIM-карты.
properties.siteProvisioningState

object

Словарь сайтов для состояния подготовки этой SIM-карты на этом сайте.
properties.staticIpConfiguration

SimStaticIpProperties[]

Список статических IP-адресов, назначенных этой SIM-карте. Каждый адрес назначается в определенной сетевой область, состоящей из {подключенной сети данных, среза}.
properties.vendorKeyFingerprint

string

Общедоступный отпечаток ключа поставщика SIM-карты, который предоставил эту SIM-карту, если она есть.
properties.vendorName

string

Имя поставщика SIM-карты, который предоставил эту SIM-карту, если она есть.
systemData

systemData

Azure Resource Manager метаданные, содержащие сведения createdBy и modifiedBy.
type

string

Тип ресурса. Например, Microsoft.Compute/virtualMachines или Microsoft.Storage/storageAccounts.

SimPolicyResourceId

Ссылка на ресурс политики SIM-карты.

Имя Тип Описание
id

string

Идентификатор ресурса политики SIM-карты.

SimState

Состояние ресурса SIM-карты.

Имя Тип Описание
Disabled

string

SIM-карта отключена, так как присутствует не вся конфигурация, необходимая для включения.
Enabled

string

SIM-карта включена.
Invalid

string

Не удается включить SIM-карту, так как часть связанной конфигурации недопустима.

SimStaticIpProperties

Статическая IP-конфигурация для SIM-карты, ограниченная определенной подключенной сетью данных и срезом.

Имя Тип Описание
attachedDataNetwork

AttachedDataNetworkResourceId

Подключенная сеть данных, в которой будет использоваться статический IP-адрес. Сочетание подключенной сети данных и среза определяет сетевой область IP-адреса. Подключенная сеть данных должна находиться в том же расположении, что и SIM-карта.
slice

SliceResourceId

Срез сети, в котором будет использоваться статический IP-адрес. Сочетание подключенной сети данных и среза определяет сетевой область IP-адреса. Срез должен находиться в том же расположении, что и SIM-карта.
staticIp

StaticIp

Статическая IP-конфигурация для SIM-карты, используемая в определенной сетевой область.

SliceResourceId

Ссылка на ресурс среза.

Имя Тип Описание
id

string

Идентификатор ресурса среза.

StaticIp

Статическая IP-конфигурация для SIM-карты, используемая в определенной сетевой область.

Имя Тип Описание
ipv4Address

string

IPv4-адрес, назначенный SIM-карте в этой сети, область. Этот адрес должен находиться в userEquipmentStaticAddressPoolPrefix, определенном в подключенной сети данных.

systemData

Метаданные, относящиеся к созданию и последнему изменению ресурса.

Имя Тип Описание
createdAt

string

Метка времени создания ресурса (UTC).
createdBy

string

Удостоверение, создающее ресурс.
createdByType

createdByType

Тип удостоверения, создавшего ресурс.
lastModifiedAt

string

Метка времени последнего изменения ресурса (UTC)
lastModifiedBy

string

Удостоверение, которое последним изменял ресурс.
lastModifiedByType

createdByType

Тип удостоверения, которое последним изменял ресурс.