Versi 4 (V4) dari AWS SDK untuk .NET telah dirilis\$1

Untuk informasi tentang melanggar perubahan dan memigrasi aplikasi Anda, lihat [topik migrasi](https://docs.aws.amazon.com/sdk-for-net/v4/developer-guide/net-dg-v4.html).

 [https://docs.aws.amazon.com/sdk-for-net/v4/developer-guide/net-dg-v4.html](https://docs.aws.amazon.com/sdk-for-net/v4/developer-guide/net-dg-v4.html)

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Mengkonfigurasi Parameter Aplikasi Lainnya
<a name="net-dg-config-other"></a>

**catatan**  
Informasi dalam topik ini khusus untuk proyek berdasarkan .NET Framework. `Web.config`File `App.config` dan tidak ada secara default dalam proyek berdasarkan .NET Core.

## Terbuka untuk melihat konten.NET Framework
<a name="w2aac11c29b9b5b1"></a>

Ada sejumlah parameter aplikasi yang dapat Anda konfigurasikan:
+  `AWSLogging` 
+  `AWSLogMetrics` 
+  `AWSRegion` 
+  `AWSResponseLogging` 
+  `AWS.DynamoDBContext.TableNamePrefix` 
+  `AWS.S3.UseSignatureVersion4` 
+  `AWSEndpointDefinition` 
+  [AWS Titik Akhir yang Dihasilkan Layanan](#config-setting-service-generated-awsendpointdefinition) 

Parameter ini dapat dikonfigurasi dalam aplikasi `App.config` atau `Web.config` file. Meskipun Anda juga dapat mengonfigurasinya dengan AWS SDK untuk .NET API, kami sarankan Anda menggunakan `.config` file aplikasi. Kedua pendekatan tersebut dijelaskan di sini.

Untuk informasi selengkapnya tentang penggunaan `<aws>` elemen seperti yang dijelaskan nanti dalam topik ini, lihat [Referensi File Konfigurasi untuk AWS SDK untuk .NET](net-dg-config-ref.md).

### AWSLogging
<a name="config-setting-awslogging"></a>

Mengonfigurasi bagaimana SDK harus mencatat peristiwa, jika ada. Misalnya, pendekatan yang disarankan adalah dengan menggunakan `<logging>` elemen, yang merupakan elemen anak dari `<aws>` elemen:

```
<aws>
  <logging logTo="Log4Net"/>
</aws>
```

Atau:

```
<add key="AWSLogging" value="log4net"/>
```

Nilai yang mungkin adalah:

** `None` **  
Matikan pencatatan peristiwa. Ini adalah opsi default.

** `log4net` **  
Log menggunakan log4net.

** `SystemDiagnostics` **  
Log menggunakan `System.Diagnostics` kelas.

Anda dapat mengatur beberapa nilai untuk `logTo` atribut, dipisahkan dengan koma. Contoh berikut menetapkan keduanya `log4net` dan `System.Diagnostics` masuk ke dalam `.config` file:

```
<logging logTo="Log4Net, SystemDiagnostics"/>
```

Atau:

```
<add key="AWSLogging" value="log4net, SystemDiagnostics"/>
```

[Atau, dengan menggunakan AWS SDK untuk .NET API, gabungkan nilai [LoggingOptions](https://docs.aws.amazon.com/sdkfornet/v4/apidocs/items/Amazon/TLoggingOptions.html)enumerasi dan setel properti .Logging: AWSConfigs](https://docs.aws.amazon.com/sdkfornet/v4/apidocs/items/Amazon/TAWSConfigs.html)

```
AWSConfigs.Logging = LoggingOptions.Log4Net | LoggingOptions.SystemDiagnostics;
```

Perubahan pada pengaturan ini hanya berlaku untuk instance AWS klien baru.

### AWSLogMetrik
<a name="config-setting-awslogmetrics"></a>

Menentukan apakah SDK harus mencatat metrik kinerja atau tidak. Untuk mengatur konfigurasi logging metrik dalam `.config` file, atur nilai `logMetrics` atribut dalam `<logging>` elemen, yang merupakan elemen anak dari `<aws>` elemen:

```
<aws>
  <logging logMetrics="true"/>
</aws>
```

Atau, atur `AWSLogMetrics` kunci di `<appSettings>` bagian:

```
<add key="AWSLogMetrics" value="true">
```

[Atau, untuk menyetel pencatatan metrik dengan AWS SDK untuk .NET API, setel file. AWSConfigs LogMetrics](https://docs.aws.amazon.com/sdkfornet/v4/apidocs/items/Amazon/TAWSConfigs.html)properti:

```
AWSConfigs.LogMetrics = true;
```

Pengaturan ini mengkonfigurasi `LogMetrics` properti default untuk semua klien/konfigurasi. Perubahan pada pengaturan ini hanya berlaku untuk instance AWS klien baru.

### AWSRegion
<a name="config-setting-awsregion"></a>

Mengkonfigurasi AWS wilayah default untuk klien yang belum secara eksplisit menentukan wilayah. Untuk mengatur wilayah dalam `.config` file, pendekatan yang disarankan adalah mengatur nilai `region` atribut dalam `aws` elemen:

```
<aws region="us-west-2"/>
```

Atau, atur *AWSRegion*kunci di `<appSettings>` bagian:

```
<add key="AWSRegion" value="us-west-2"/>
```

Atau, untuk menyetel wilayah dengan AWS SDK untuk .NET API, atur [AWSConfigs. AWSRegion](https://docs.aws.amazon.com/sdkfornet/v4/apidocs/items/Amazon/TAWSConfigs.html)properti:

```
AWSConfigs.AWSRegion = "us-west-2";
```

Untuk informasi selengkapnya tentang membuat AWS klien untuk wilayah tertentu, lihat [Pemilihan AWS Wilayah](net-dg-region-selection.md). Perubahan pada pengaturan ini hanya berlaku untuk instance AWS klien baru.

### AWSResponsePenebangan
<a name="config-setting-awsresponselogging"></a>

Mengkonfigurasi kapan SDK harus mencatat respons layanan. Nilai yang mungkin adalah:

** `Never` **  
Jangan pernah mencatat tanggapan layanan. Ini adalah opsi default.

** `Always` **  
Selalu log tanggapan layanan.

** `OnError` **  
Hanya log tanggapan layanan ketika terjadi kesalahan.

Untuk mengatur konfigurasi pencatatan layanan dalam `.config` file, pendekatan yang disarankan adalah mengatur nilai `logResponses` atribut dalam `<logging>` elemen, yang merupakan elemen anak dari `<aws>` elemen:

```
<aws>
  <logging logResponses="OnError"/>
</aws>
```

Atau, atur kunci *AWSResponseLogging* di `<appSettings>` bagian:

```
<add key="AWSResponseLogging" value="OnError"/>
```

Atau, untuk mengatur pencatatan layanan dengan AWS SDK untuk .NET API, setel file [AWSConfigs. ResponseLogging](https://docs.aws.amazon.com/sdkfornet/v4/apidocs/items/Amazon/TAWSConfigs.html)properti ke salah satu nilai [ResponseLoggingOption](https://docs.aws.amazon.com/sdkfornet/v4/apidocs/items/Amazon/TResponseLoggingOption.html)pencacahan:

```
AWSConfigs.ResponseLogging = ResponseLoggingOption.OnError;
```

Perubahan pada pengaturan ini segera berlaku.

### `AWS.DynamoDBContext.TableNamePrefix`
<a name="config-setting-aws-dynamodbcontext-tablenameprefix"></a>

Mengkonfigurasi default `TableNamePrefix` yang `DynamoDBContext` akan digunakan jika tidak dikonfigurasi secara manual.

Untuk mengatur awalan nama tabel dalam `.config` file, pendekatan yang disarankan adalah mengatur nilai `tableNamePrefix` atribut dalam `<dynamoDBContext>` elemen, yang merupakan elemen anak dari `<dynamoDB>` elemen, yang merupakan elemen anak dari `<aws>` elemen:

```
<dynamoDBContext tableNamePrefix="Test-"/>
```

Atau, atur `AWS.DynamoDBContext.TableNamePrefix` kunci di `<appSettings>` bagian:

```
<add key="AWS.DynamoDBContext.TableNamePrefix" value="Test-"/>
```

Atau, untuk mengatur awalan nama tabel dengan AWS SDK untuk .NET API, setel properti [AWSConfigs.Dynamo DBContext TableNamePrefix](https://docs.aws.amazon.com/sdkfornet/v4/apidocs/items/Amazon/TAWSConfigs.html):

```
AWSConfigs.DynamoDBContextTableNamePrefix = "Test-";
```

Perubahan pada pengaturan ini hanya akan berlaku dalam contoh yang baru dibangun dari `DynamoDBContextConfig` dan`DynamoDBContext`.

### `AWS.S3.UseSignatureVersion4`
<a name="config-setting-aws-s3-usesignatureversion4"></a>

Mengkonfigurasi apakah klien Amazon S3 harus menggunakan tanda tangan versi 4 penandatanganan dengan permintaan atau tidak.

Untuk mengatur tanda tangan versi 4 penandatanganan untuk Amazon S3 dalam `.config` file, pendekatan yang disarankan adalah mengatur `useSignatureVersion4` atribut `<s3>` elemen, yang merupakan elemen turunan dari elemen: `<aws>`

```
<aws>
  <s3 useSignatureVersion4="true"/>
</aws>
```

Atau, atur `AWS.S3.UseSignatureVersion4` kuncinya `true` di `<appSettings>` bagian:

```
<add key="AWS.S3.UseSignatureVersion4" value="true"/>
```

Atau, untuk menyetel tanda tangan penandatanganan versi 4 dengan AWS SDK untuk .NET API, setel [AWSConfigsproperti.S3 UseSignatureVersion 4](https://docs.aws.amazon.com/sdkfornet/v4/apidocs/items/Amazon/TAWSConfigs.html) ke: `true`

```
AWSConfigs.S3UseSignatureVersion4 = true;
```

Secara default, pengaturan ini`false`, tetapi versi tanda tangan 4 dapat digunakan secara default dalam beberapa kasus atau dengan beberapa wilayah. Saat pengaturannya`true`, tanda tangan versi 4 akan digunakan untuk semua permintaan. Perubahan pada setelan ini hanya berlaku untuk instans klien Amazon S3 baru.

### AWSEndpointDefinisi
<a name="config-setting-awsendpointdefinition"></a>

Mengkonfigurasi apakah SDK harus menggunakan file konfigurasi khusus yang mendefinisikan wilayah dan titik akhir.

Untuk mengatur file definisi titik akhir dalam `.config` file, kami sarankan untuk mengatur nilai `endpointDefinition` atribut dalam `<aws>` elemen.

```
<aws endpointDefinition="c:\config\endpoints.json"/>
```

Atau, Anda dapat mengatur kunci *AWSEndpointDefinisi* di `<appSettings>` bagian:

```
<add key="AWSEndpointDefinition" value="c:\config\endpoints.json"/>
```

[Atau, untuk menyetel file definisi titik akhir dengan AWS SDK untuk .NET API, setel file. AWSConfigs EndpointDefinition](https://docs.aws.amazon.com/sdkfornet/v4/apidocs/items/Amazon/TAWSConfigs.html)properti:

```
AWSConfigs.EndpointDefinition = @"c:\config\endpoints.json";
```

Jika tidak ada nama file yang disediakan, maka file konfigurasi khusus tidak akan digunakan. Perubahan pada pengaturan ini hanya berlaku untuk instance AWS klien baru. `endpoints.json`File tersedia dari[https://github.com/aws/aws-sdk-net/blob/main/sdk/src/Core/endpoints.json](https://github.com/aws/aws-sdk-net/blob/main/sdk/src/Core/endpoints.json).

### AWS Titik Akhir yang Dihasilkan Layanan
<a name="config-setting-service-generated-awsendpointdefinition"></a>

Beberapa AWS layanan menghasilkan titik akhir mereka sendiri alih-alih menggunakan titik akhir wilayah. Klien untuk layanan ini menggunakan URL layanan yang khusus untuk layanan itu dan sumber daya Anda. Dua contoh layanan ini adalah Amazon CloudSearch dan AWS IoT. Contoh berikut menunjukkan bagaimana Anda dapat memperoleh titik akhir untuk layanan tersebut.

#### Contoh CloudSearch Titik Akhir Amazon
<a name="cs-endpoints-example"></a>

 CloudSearch Klien Amazon digunakan untuk mengakses layanan CloudSearch konfigurasi Amazon. Anda menggunakan layanan CloudSearch konfigurasi Amazon untuk membuat, mengonfigurasi, dan mengelola domain penelusuran. Untuk membuat domain pencarian, buat [CreateDomainRequest](https://docs.aws.amazon.com/sdkfornet/v4/apidocs/items/CloudSearch/TCreateDomainRequest.html)objek dan berikan `DomainName` properti. Buat [AmazonCloudSearchClient](https://docs.aws.amazon.com/sdkfornet/v4/apidocs/items/CloudSearch/TCloudSearchClient.html)objek dengan menggunakan objek permintaan. Panggil metode [CreateDomain](https://docs.aws.amazon.com/sdkfornet/v4/apidocs/items/CloudSearch/MCloudSearchCreateDomainCreateDomainRequest.html). [CreateDomainResponse](https://docs.aws.amazon.com/sdkfornet/v4/apidocs/items/CloudSearch/TCreateDomainResponse.html)Objek yang dikembalikan dari panggilan berisi `DomainStatus` properti yang memiliki titik akhir `DocService` dan `SearchService` titik akhir. Buat [AmazonCloudSearchDomainConfig](https://docs.aws.amazon.com/sdkfornet/v4/apidocs/items/CloudSearchDomain/TCloudSearchDomainConfig.html)objek dan gunakan untuk menginisialisasi `DocService` dan `SearchService` contoh kelas. [AmazonCloudSearchDomainClient](https://docs.aws.amazon.com/sdkfornet/v4/apidocs/items/CloudSearchDomain/TCloudSearchDomainClient.html)

```
// Create domain and retrieve DocService and SearchService endpoints
DomainStatus domainStatus;
using (var searchClient = new AmazonCloudSearchClient())
{
    var request = new CreateDomainRequest
    {
        DomainName = "testdomain"
    };
    domainStatus = searchClient.CreateDomain(request).DomainStatus;
    Console.WriteLine(domainStatus.DomainName + " created");
}

// Test the DocService endpoint
var docServiceConfig = new AmazonCloudSearchDomainConfig
{
    ServiceURL = "https://" + domainStatus.DocService.Endpoint
};
using (var domainDocService = new AmazonCloudSearchDomainClient(docServiceConfig))
{
    Console.WriteLine("Amazon CloudSearchDomain DocService client instantiated using the DocService endpoint");
    Console.WriteLine("DocService endpoint = " + domainStatus.DocService.Endpoint);

    using (var docStream = new FileStream(@"C:\doc_source\XMLFile4.xml", FileMode.Open))
    {
        var upload = new UploadDocumentsRequest
        {
            ContentType = ContentType.ApplicationXml,
            Documents = docStream
        };
        domainDocService.UploadDocuments(upload);
    }
}

// Test the SearchService endpoint
var searchServiceConfig = new AmazonCloudSearchDomainConfig
{
    ServiceURL = "https://" + domainStatus.SearchService.Endpoint
};
using (var domainSearchService = new AmazonCloudSearchDomainClient(searchServiceConfig))
{
    Console.WriteLine("Amazon CloudSearchDomain SearchService client instantiated using the SearchService endpoint");
    Console.WriteLine("SearchService endpoint = " + domainStatus.SearchService.Endpoint);

    var searchReq = new SearchRequest
    {
        Query = "Gambardella",
        Sort = "_score desc",
        QueryParser = QueryParser.Simple
    };
    var searchResp = domainSearchService.Search(searchReq);
}
```

#### AWS IoT Contoh Titik Akhir
<a name="iotlong-endpoints-example"></a>

Untuk mendapatkan titik akhir untuk AWS IoT, buat [AmazonIoTClient](https://docs.aws.amazon.com/sdkfornet/v4/apidocs/items/IoT/TIoTClient.html)objek dan panggil [DescribeEndPoint](https://docs.aws.amazon.com/sdkfornet/v4/apidocs/items/IoT/MIoTDescribeEndpointDescribeEndpointRequest.html)metode. [DescribeEndPointResponse](https://docs.aws.amazon.com/sdkfornet/v4/apidocs/items/IoT/TDescribeEndpointResponse.html)Objek yang dikembalikan berisi file`EndpointAddress`. Buat [AmazonIotDataConfig](https://docs.aws.amazon.com/sdkfornet/v4/apidocs/items/IotData/TIotDataConfig.html)objek, atur `ServiceURL` properti, dan gunakan objek untuk membuat instance kelas. [AmazonIotDataClient](https://docs.aws.amazon.com/sdkfornet/v4/apidocs/items/IotData/TIotDataClient.html)

```
string iotEndpointAddress;
using (var iotClient = new AmazonIoTClient())
{
    var endPointResponse = iotClient.DescribeEndpoint();
    iotEndpointAddress = endPointResponse.EndpointAddress;
}

var ioTdocServiceConfig = new AmazonIotDataConfig
{
    ServiceURL = "https://" + iotEndpointAddress
};
using (var dataClient = new AmazonIotDataClient(ioTdocServiceConfig))
{
    Console.WriteLine("AWS IoTData client instantiated using the endpoint from the IotClient");
}
```