Packet Captures - Create
Создайте и запустите запись пакетов на указанной виртуальной машине.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkWatchers/{networkWatcherName}/packetCaptures/{packetCaptureName}?api-version=2023-09-01
Параметры URI
Имя | В | Обязательно | Тип | Описание |
---|---|---|---|---|
network
|
path | True |
string |
Имя наблюдателя за сетями. |
packet
|
path | True |
string |
Имя сеанса записи пакетов. |
resource
|
path | True |
string |
Имя группы ресурсов. |
subscription
|
path | True |
string |
Учетные данные подписки, которые однозначно идентифицируют подписку Microsoft Azure. Идентификатор подписки формирует часть URI для каждого вызова службы. |
api-version
|
query | True |
string |
Версия API клиента. |
Текст запроса
Имя | Обязательно | Тип | Описание |
---|---|---|---|
properties.storageLocation | True |
Место хранения для сеанса записи пакетов. |
|
properties.target | True |
string |
В настоящее время поддерживаются идентификатор целевого ресурса, только AzureVM и AzureVMSS в качестве целевого типа. |
properties.bytesToCapturePerPacket |
integer |
Количество байтов, захваченных на пакет, остальные байты усекаются. |
|
properties.filters |
Список фильтров записи пакетов. |
||
properties.scope |
Список экземпляров AzureVMSS, которые можно включить или исключить для выполнения записи пакетов. Если включенные и исключенные значения пусты, запись пакетов будет выполняться на всех экземплярах AzureVMSS. |
||
properties.targetType |
Целевой тип предоставленного ресурса. |
||
properties.timeLimitInSeconds |
integer |
Максимальная продолжительность сеанса записи в секундах. |
|
properties.totalBytesPerSession |
integer |
Максимальный размер выходных данных записи. |
Ответы
Имя | Тип | Описание |
---|---|---|
201 Created |
Запрос выполнен успешно. Операция возвращает результирующий сеанс записи пакетов. |
|
Other Status Codes |
Ответ об ошибке, описывающий причину сбоя операции. |
Безопасность
azure_auth
Поток OAuth2 в Azure Active Directory.
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Имя | Описание |
---|---|
user_impersonation | олицетворения учетной записи пользователя |
Примеры
Create packet capture
Sample Request
PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/networkWatchers/nw1/packetCaptures/pc1?api-version=2023-09-01
{
"properties": {
"target": "/subscriptions/subid/resourceGroups/rg2/providers/Microsoft.Compute/virtualMachines/vm1",
"bytesToCapturePerPacket": 10000,
"totalBytesPerSession": 100000,
"timeLimitInSeconds": 100,
"storageLocation": {
"storageId": "/subscriptions/subid/resourceGroups/rg2/providers/Microsoft.Storage/storageAccounts/pcstore",
"storagePath": "https://mytestaccountname.blob.core.windows.net/capture/pc1.cap",
"filePath": "D:\\capture\\pc1.cap"
},
"filters": [
{
"protocol": "TCP",
"localIPAddress": "10.0.0.4",
"localPort": "80"
}
]
}
}
Sample Response
{
"name": "pc1",
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/networkWatchers/nw1/packetCaptures/pc1",
"properties": {
"provisioningState": "Updating",
"target": "/subscriptions/subid/resourceGroups/rg2/providers/Microsoft.Compute/virtualMachines/vm1",
"bytesToCapturePerPacket": 10000,
"totalBytesPerSession": 100000,
"timeLimitInSeconds": 100,
"storageLocation": {
"storageId": "/subscriptions/subid/resourceGroups/rg2/providers/Microsoft.Storage/storageAccounts/pcstore",
"storagePath": "https://mytestaccountname.blob.core.windows.net/capture/pc1.cap",
"filePath": "D:\\capture\\pc1.cap"
},
"filters": [
{
"protocol": "TCP",
"localIPAddress": "10.0.0.4",
"localPort": "80"
}
]
}
}
Определения
Имя | Описание |
---|---|
Error |
Представление сведений о распространенных ошибках. |
Error |
Объект error. |
Packet |
Параметры, определяющие операцию создания записи пакетов. |
Packet |
Фильтр, применяемый к запросу на сбор пакетов. Можно применить несколько фильтров. |
Packet |
Список экземпляров AzureVMSS, которые можно включить или исключить для выполнения записи пакетов. Если включенные и исключенные значения пусты, запись пакетов будет выполняться на всех экземплярах AzureVMSS. |
Packet |
Сведения о сеансе записи пакетов. |
Packet |
Место хранения для сеанса записи пакетов. |
Packet |
Целевой тип предоставленного ресурса. |
Pc |
Протокол для фильтрации. |
Provisioning |
Текущее состояние подготовки. |
ErrorDetails
Представление сведений о распространенных ошибках.
Имя | Тип | Описание |
---|---|---|
code |
string |
Код ошибки. |
message |
string |
Сообщение об ошибке. |
target |
string |
Целевой объект ошибки. |
ErrorResponse
Объект error.
Имя | Тип | Описание |
---|---|---|
error |
Ошибка |
PacketCapture
Параметры, определяющие операцию создания записи пакетов.
Имя | Тип | Значение по умолчанию | Описание |
---|---|---|---|
properties.bytesToCapturePerPacket |
integer |
0 |
Количество байтов, захваченных на пакет, остальные байты усекаются. |
properties.filters |
Список фильтров записи пакетов. |
||
properties.scope |
Список экземпляров AzureVMSS, которые можно включить или исключить для выполнения записи пакетов. Если включенные и исключенные значения пусты, запись пакетов будет выполняться на всех экземплярах AzureVMSS. |
||
properties.storageLocation |
Место хранения для сеанса записи пакетов. |
||
properties.target |
string |
В настоящее время поддерживаются идентификатор целевого ресурса, только AzureVM и AzureVMSS в качестве целевого типа. |
|
properties.targetType |
Целевой тип предоставленного ресурса. |
||
properties.timeLimitInSeconds |
integer |
18000 |
Максимальная продолжительность сеанса записи в секундах. |
properties.totalBytesPerSession |
integer |
1073741824 |
Максимальный размер выходных данных записи. |
PacketCaptureFilter
Фильтр, применяемый к запросу на сбор пакетов. Можно применить несколько фильтров.
Имя | Тип | Значение по умолчанию | Описание |
---|---|---|---|
localIPAddress |
string |
Локальный IP-адрес для фильтрации. Нотация: "127.0.0.1" для записи с одним адресом. "127.0.0.1-127.0.0.255" для диапазона. "127.0.0.1; 127.0.0.5"? для нескольких записей. Несколько диапазонов в настоящее время не поддерживаются. Смешивание диапазонов с несколькими записями в настоящее время не поддерживается. По умолчанию = null. |
|
localPort |
string |
Локальный порт для фильтрации. Нотация: "80" для входа с одним портом". 80–85 дюймов для диапазона. "80; 443;" для нескольких записей. Несколько диапазонов в настоящее время не поддерживаются. Смешивание диапазонов с несколькими записями в настоящее время не поддерживается. По умолчанию = null. |
|
protocol | Any |
Протокол для фильтрации. |
|
remoteIPAddress |
string |
Локальный IP-адрес для фильтрации. Нотация: "127.0.0.1" для записи с одним адресом. "127.0.0.1-127.0.0.255" для диапазона. "127.0.0.1; 127.0.0.5;" для нескольких записей. Несколько диапазонов в настоящее время не поддерживаются. Смешивание диапазонов с несколькими записями в настоящее время не поддерживается. По умолчанию = null. |
|
remotePort |
string |
Удаленный порт для фильтрации. Нотация: "80" для входа с одним портом". 80–85 дюймов для диапазона. "80; 443;" для нескольких записей. Несколько диапазонов в настоящее время не поддерживаются. Смешивание диапазонов с несколькими записями в настоящее время не поддерживается. По умолчанию = null. |
PacketCaptureMachineScope
Список экземпляров AzureVMSS, которые можно включить или исключить для выполнения записи пакетов. Если включенные и исключенные значения пусты, запись пакетов будет выполняться на всех экземплярах AzureVMSS.
Имя | Тип | Описание |
---|---|---|
exclude |
string[] |
Список экземпляров AzureVMSS, которые должны быть исключены из AzureVMSS из записи пакетов. |
include |
string[] |
Список экземпляров AzureVMSS для записи пакетов. |
PacketCaptureResult
Сведения о сеансе записи пакетов.
Имя | Тип | Значение по умолчанию | Описание |
---|---|---|---|
etag |
string |
Уникальная строка, доступная только для чтения, которая изменяется при каждом обновлении ресурса. |
|
id |
string |
Идентификатор операции записи пакетов. |
|
name |
string |
Имя сеанса записи пакетов. |
|
properties.bytesToCapturePerPacket |
integer |
0 |
Количество байтов, захваченных на пакет, остальные байты усекаются. |
properties.filters |
Список фильтров записи пакетов. |
||
properties.provisioningState |
Состояние подготовки сеанса записи пакетов. |
||
properties.scope |
Список экземпляров AzureVMSS, которые можно включить или исключить для выполнения записи пакетов. Если включенные и исключенные значения пусты, запись пакетов будет выполняться на всех экземплярах AzureVMSS. |
||
properties.storageLocation |
Место хранения для сеанса записи пакетов. |
||
properties.target |
string |
В настоящее время поддерживаются идентификатор целевого ресурса, только AzureVM и AzureVMSS в качестве целевого типа. |
|
properties.targetType |
Целевой тип предоставленного ресурса. |
||
properties.timeLimitInSeconds |
integer |
18000 |
Максимальная продолжительность сеанса записи в секундах. |
properties.totalBytesPerSession |
integer |
1073741824 |
Максимальный размер выходных данных записи. |
PacketCaptureStorageLocation
Место хранения для сеанса записи пакетов.
Имя | Тип | Описание |
---|---|---|
filePath |
string |
Допустимый локальный путь на целевой виртуальной машине. Должно содержать имя файла записи (*.cap). Для виртуальной машины Linux она должна начинаться с /var/captures. Требуется, если идентификатор хранилища не указан, в противном случае — необязательный. |
storageId |
string |
Идентификатор учетной записи хранения для сохранения сеанса записи пакетов. Требуется, если путь к локальному файлу не указан. |
storagePath |
string |
Универсальный код ресурса (URI) пути к хранилищу для сохранения записи пакетов. Должен быть правильным универсальным кодом ресурса (URI), описывающим расположение для сохранения записи пакетов. |
PacketCaptureTargetType
Целевой тип предоставленного ресурса.
Имя | Тип | Описание |
---|---|---|
AzureVM |
string |
|
AzureVMSS |
string |
PcProtocol
Протокол для фильтрации.
Имя | Тип | Описание |
---|---|---|
Any |
string |
|
TCP |
string |
|
UDP |
string |
ProvisioningState
Текущее состояние подготовки.
Имя | Тип | Описание |
---|---|---|
Deleting |
string |
|
Failed |
string |
|
Succeeded |
string |
|
Updating |
string |