UpdateTrail - - Alibaba Cloud Dokümantasyon Merkezi

Bir izlemenin yapılandırmalarını günceller.

Operation description

Bu konu, trail-test adlı örnek bir izlemenin hedef Object Storage Service (OSS) bucket'ını audit-log olarak nasıl değiştireceğinizi gösterir.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.
API: The API that you can call to perform the action.
Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.
Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.
- For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.
- For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.
Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.
Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

actiontrail:UpdateTrail

update

*Trail

acs:actiontrail:{#regionId}:{#accountId}:trail/{#TrailName}

None

Request parameters

Parameter	Type	Required	Description	Example
Name	string	Yes	Yapılandırmalarını güncellemek istediğiniz izlemenin adı. Ad, 6 ila 36 karakter uzunluğunda olmalıdır ve küçük harfler, rakamlar, tireler (-) ve alt çizgiler (_) içerebilir. Küçük bir harfle başlamalıdır. Not Ad, bir Alibaba Cloud hesabı içinde benzersiz olmalıdır.	trail-test
OssBucketName	string	No	Olayları iletmek istediğiniz Object Storage Service (OSS) bucket'ının adı. Ad, 3 ila 63 karakter uzunluğunda olmalıdır. Ad küçük bir harf veya rakamla başlamalıdır ve küçük harfler, rakamlar ve tireler (-) içerebilir. Not İzlemenin yapılandırmasını güncellemeden önce bucket'ın var olduğundan emin olun.	audit-log
OssKeyPrefix	string	No	OSS bucket'ında depolanan dosyaların ön eki. Ön ek, 6 ila 32 karakter uzunluğunda olmalıdır. Ön ek bir harfle başlamalıdır ve harfler, rakamlar, tireler (-), eğik çizgiler (/) ve alt çizgiler (_) içerebilir.	at-product-account-audit-B
OssWriteRoleArn	string	No	ActionTrail'in olayları OSS bucket'ına iletmek için üstlendiği RAM rolünün Alibaba Cloud Kaynak Adı (ARN) değeri. Bu parametreyi belirtmezseniz, ActionTrail gerekli kaynakları oluşturmak için hizmete bağlı bir rol oluşturur. Daha fazla bilgi için Hizmete bağlı rolü yönetme konusuna bakın. Bu parametreyi belirtirseniz, olayları Alibaba Cloud hesabınıza iletebilmeniz için ActionTrail'in üstlendiği hizmete bağlı rolün izinlerini RAM rolüne vermeniz gerekir. Olayları diğer Alibaba Cloud hesaplarına iletmeniz gerekiyorsa, olay iletimiyle ilgili izinleri vermek için kullanılan izin politikasını RAM rolüne eklemeniz gerekir. Alibaba Cloud hesapları arasında olay iletimi hakkında daha fazla bilgi için Alibaba Cloud hesapları arasında olay iletme konusuna bakın.	acs:ram::151266687691****:role/aliyunserviceroleforactiontrail
SlsProjectArn	string	No	Olayları iletmek istediğiniz Log Service projesinin ARN değeri.	acs:log:cn-shanghai:151266687691****:project/test-project
SlsWriteRoleArn	string	No	ActionTrail'in olayları Log Service projesine iletmek için üstlendiği RAM rolünün ARN değeri. Bu parametreyi belirtmezseniz, ActionTrail ilgili kaynağı oluşturmak için hizmete bağlı bir rol oluşturur. Daha fazla bilgi için Hizmete bağlı rolü yönetme konusuna bakın. Bu parametreyi belirtirseniz, olayları Alibaba Cloud hesabınıza iletebilmeniz için ActionTrail'in üstlendiği hizmete bağlı rolün izinlerini RAM rolüne vermeniz gerekir. Olayları diğer Alibaba Cloud hesaplarına iletmeniz gerekiyorsa, olay iletimiyle ilgili izinleri vermek için kullanılan izin politikasını RAM rolüne eklemeniz gerekir. Alibaba Cloud hesapları arasında olay iletimi hakkında daha fazla bilgi için Alibaba Cloud hesapları arasında olay iletme konusuna bakın.	acs:ram::151266687691****:role/aliyunserviceroleforactiontrail
EventRW	string	No	İletilecek olayların okuma/yazma türü. Geçerli değerler: Write: yazma olayları. Varsayılan değerdir. Read: okuma olayları. All: okuma ve yazma olayları.	All
TrailRegion	string	No	İzlemenin bölgesi. Varsayılan değer All değeridir ve bu, izlemenin tüm bölgelerden olayları ilettiğini gösterir. Belirli bölgeler de belirtebilirsiniz. Desteklenen tüm bölgeleri sorgulamak için DescribeRegions işlemini çağırabilirsiniz.	All
MaxComputeProjectArn	string	No	Olayları iletmek istediğiniz MaxCompute projesinin ARN değeri. Not MaxCompute projesinin adı actiontrail_ ön ekiyle başlamalıdır.	acs:odps:cn-hangzhou:、151277687691**:project/actiontrail_**
MaxComputeWriteRoleArn	string	No	ActionTrail'in olayları hedef Simple Log Service projesine iletmek için üstlendiği rolün ARN değeri. Bu parametreyi belirtmezseniz, ActionTrail gerekli kaynakları oluşturmak için hizmete bağlı bir rol oluşturur. Daha fazla bilgi için Hizmete bağlı rolü yönetme konusuna bakın. Bu parametreyi belirtir ve olayları mevcut hesaba iletirseniz, RAM rolüne ActionTrail için hizmete bağlı rolün izinlerini vermeniz gerekir. Olayları diğer hesaplara iletmek istiyorsanız, RAM rolüne bir sistem politikası eklemeniz gerekir. Alibaba Cloud hesapları arasında olay iletimi hakkında daha fazla bilgi için Alibaba Cloud hesapları arasında olay iletme konusuna bakın.	acs:ram::151277687691****:role/aliyunserviceroleforactiontrail

Ortak istek parametreleri hakkında daha fazla bilgi için Ortak parametreler konusuna bakın.

Response elements

Element	Type	Description	Example
	object
EventRW	string	İletilecek olayların okuma/yazma türü.	Write
HomeRegion	string	İzlemenin ana bölgesi.	cn-hangzhou
MaxComputeProjectArn	string	İzleme iletimi için Big Data Compute Service projesinin ARN değeri.	acs:odps:cn-hangzhou:151266687691**:project/actiontrail_**
MaxComputeWriteRoleArn	string	Operation Audit'in işlem olaylarını Big Data Compute Service projesine iletirken üstlendiği rolün ARN değeri.	acs:ram::151266687691****:role/aliyunserviceroleforactiontrail
Name	string	İzlemenin adı.	trail-test
OssBucketName	string	OSS bucket'ının adı.	audit-log
OssKeyPrefix	string	Hedef OSS bucket'ında depolanacak günlük dosyalarının ön eki.	at-product-account-audit-B
OssWriteRoleArn	string	ActionTrail'in olayları OSS bucket'ına iletmek için üstlendiği RAM rolünün ARN değeri.	acs:ram::151266687691****:role/aliyunserviceroleforactiontrail
RequestId	string	İsteğin kimliği.	2599A180-5236-44D8-9490-50B6F4F8BA35
SlsProjectArn	string	Olayların iletileceği Log Service projesinin ARN değeri.	acs:log:cn-hangzhou:151266687691****:project/test-project
SlsWriteRoleArn	string	ActionTrail'in olayları Log Service projesine iletmek için üstlendiği RAM rolünün ARN değeri.	acs:ram::151266687691****:role/aliyunserviceroleforactiontrail
TrailRegion	string	İzlemenin olayları ilettiği bir veya daha fazla bölge.	All

Examples

Success response

JSON format

{
  "EventRW": "Write",
  "HomeRegion": "cn-hangzhou",
  "MaxComputeProjectArn": "acs:odps:cn-hangzhou:151266687691****:project/actiontrail_****",
  "MaxComputeWriteRoleArn": "acs:ram::151266687691****:role/aliyunserviceroleforactiontrail",
  "Name": "trail-test",
  "OssBucketName": "audit-log",
  "OssKeyPrefix": "at-product-account-audit-B",
  "OssWriteRoleArn": "acs:ram::151266687691****:role/aliyunserviceroleforactiontrail",
  "RequestId": "2599A180-5236-44D8-9490-50B6F4F8BA35",
  "SlsProjectArn": "acs:log:cn-hangzhou:151266687691****:project/test-project",
  "SlsWriteRoleArn": "acs:ram::151266687691****:role/aliyunserviceroleforactiontrail",
  "TrailRegion": "All"
}

Error codes

HTTP status code	Error code	Error message	Description
400	RepeatOssBucket	The specified OSS bucket is already in use. We recommend that you modify the existing Trail or specify another bucket.
400	SlsProjectDoesNotExistException	The specified Log Service project does not exist.
400	IncompleteSignature	The request signature does not conform to Alibaba Cloud standards.	The request signature does not conform to Alibaba Cloud standards.
400	InvalidDeliveryConfigurationException	You must specify at least one Log Service project or OSS bucket for a Trail.
400	InvalidPrefixException	The specified OSS bucket prefix is invalid.	The specified OSS bucket prefix is not valid.
403	InsufficientBucketPolicyException	Access to the specified OSS bucket was denied.
403	InsufficientSlsPolicyException	Access to the specified Log Service project was denied.	Access SLS Project denied.
404	TrailNotFoundException	The specified Trail does not exist.	The specified Trail is not existed.
404	BucketDoesNotExistException	The specified OSS bucket does not exist.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.