Todos los productos
Search
Centro de documentos

Object Storage Service:Callbacks de carga (SDK de iOS)

Última actualización: Sep 22, 2026

En este tema se describe cómo configurar callbacks de carga.

Notas

  • Antes de ejecutar el código de ejemplo de este tema, debe crear una instancia de OSSClient mediante métodos como el uso de un nombre de dominio personalizado o Security Token Service (STS). Para obtener más información, consulte Initialization (iOS SDK).

    Nota

    La región del bucket la determina el endpoint que se especifica durante la inicialización.

  • Para cargar un objeto, necesita el permiso oss:PutObject. Para obtener más información, consulte Attach a custom policy to a RAM user.

Ejemplos

A continuación se muestra un ejemplo de código para configurar un callback de carga:

OSSPutObjectRequest * request = [OSSPutObjectRequest new];
// Specify the name of the bucket. Example: examplebucket. 
request.bucketName = @"examplebucket";
// Specify the full path of the object. Do not include the bucket name in the full path. Example: exampledir/exampleobject.txt. 
request.objectKey = @"exampledir/exampleobject.txt";
request.uploadingFileURL = [NSURL fileURLWithPath:@"<filepath>"];
// Configure callback parameters.
request.callbackParam = @{
                          @"callbackUrl": @"<your server callback address>",
                          @"callbackBody": @"<your callback body>"
                          };
// Specify custom variables. 
request.callbackVar = @{
                        @"<var1>": @"<value1>",
                        @"<var2>": @"<value2>"
                        };
request.uploadProgress = ^(int64_t bytesSent, int64_t totalByteSent, int64_t totalBytesExpectedToSend) {
    NSLog(@"%lld, %lld, %lld", bytesSent, totalByteSent, totalBytesExpectedToSend);
};
OSSTask * task = [client putObject:request];
[task continueWithBlock:^id(OSSTask *task) {
    if (task.error) {
        OSSLogError(@"%@", task.error);
    } else {
        OSSPutObjectResult * result = task.result;
        NSLog(@"Result - requestId: %@, headerFields: %@, servercallback: %@",
              result.requestId,
              result.httpResponseHeaderFields,
              result.serverReturnJsonString);
    }
    return nil;
}];
// Implement synchronous blocking to wait for the task to complete. 
// [task waitUntilFinished]; 

Referencias

  • Para consultar el código de ejemplo completo que se usa para configurar callbacks de carga, visite GitHub.

  • Para obtener más información sobre las operaciones de API que permiten configurar callbacks de carga, consulte Callback.